mirror of
https://github.com/okxlin/appstore.git
synced 2026-09-23 16:01:01 +00:00
okxlin
eb8a6dfe8d
Add Karakeep and Collabora as 1Panel v2 local apps with source evidence, strict adapter validation, and moelin/1panel:v2 smoke coverage.
61 lines
3.0 KiB
Markdown
61 lines
3.0 KiB
Markdown
# Collabora
|
|
|
|
## 产品介绍
|
|
Collabora Online Development Edition (CODE) 是基于 LibreOffice 技术的在线文档协作套件，可通过 WOPI 协议与 Nextcloud、ownCloud 等文件系统集成。
|
|
|
|
## 主要功能
|
|
- 在线编辑文本文档、表格和演示文稿
|
|
- 通过 WOPI 与 Nextcloud 等应用集成
|
|
- 提供管理控制台
|
|
- 支持按需配置允许访问的 WOPI 主机和拼写词典
|
|
|
|
## 访问说明
|
|
安装后通过 `http://<服务器 IP>:9980` 访问，实际端口以安装表单中的 `PANEL_APP_PORT_HTTP` 为准。
|
|
|
|
用于 Nextcloud 集成时，请在 Nextcloud Office/Collabora 设置中填写 Collabora 的外部访问地址，并在本应用的 `WOPI_ALIAS_GROUP` 中填写允许访问的 Nextcloud 域名。
|
|
|
|
## Introduction
|
|
Collabora Online Development Edition (CODE) is an online office suite based on LibreOffice technology for WOPI integrations such as Nextcloud and ownCloud.
|
|
|
|
## Features
|
|
- Edit text documents, spreadsheets, and presentations online
|
|
- Integrate with Nextcloud and other WOPI applications
|
|
- Built-in admin console
|
|
- Configurable WOPI host allow list and dictionaries
|
|
|
|
## 部署说明
|
|
- 本应用使用官方 Docker 镜像 `collabora/code:latest` 部署。
|
|
- 默认使用 `--o:ssl.enable=false --o:ssl.termination=true`，容器内提供 HTTP，由外部反向代理或 1Panel 网站层处理 HTTPS。
|
|
- 应用分类：工具。
|
|
- 支持架构：amd64、arm64。
|
|
- 可选版本：`latest`。
|
|
|
|
## 端口
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| PANEL_APP_PORT_HTTP | HTTP 访问端口 | 9980 | 是 |
|
|
|
|
## 数据持久化
|
|
本应用默认不挂载业务数据目录。升级或迁移前，请备份外部 WOPI 应用中的文档数据，并记录本应用安装参数。
|
|
|
|
## 参数说明
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| ADMIN_USERNAME | 管理控制台用户名 | admin | 是 |
|
|
| ADMIN_PASSWORD | 管理控制台密码 | 随机生成 | 是 |
|
|
| WOPI_ALIAS_GROUP | 允许访问的 WOPI 主机，例如 `https://nextcloud.example.com:443` | 空 | 否 |
|
|
| SERVER_NAME | 外部访问域名，反代场景可设置为 Collabora 域名 | 空 | 否 |
|
|
| DICTIONARIES | 启用的拼写词典语言列表 | de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru | 是 |
|
|
| EXTRA_PARAMS | 传给 coolwsd 的额外启动参数 | --o:ssl.enable=false --o:ssl.termination=true | 是 |
|
|
|
|
## 使用说明
|
|
- 如果只用于自测，`WOPI_ALIAS_GROUP` 可以留空；正式接入 Nextcloud 时建议填写明确的 Nextcloud HTTPS 域名。
|
|
- 官方文档示例 `aliasgroup1=https://.*:443` 会允许所有 WOPI 主机连接，仅适合公开演示场景，不建议作为默认生产配置。
|
|
- 如需容器内自签 HTTPS，可调整 `EXTRA_PARAMS`，并同步修改反向代理和探活方式。
|
|
|
|
## 参考资料
|
|
- 官网: <https://www.collaboraonline.com/code/>
|
|
- 项目仓库: <https://github.com/CollaboraOnline/online>
|
|
- CODE Docker 文档: <https://sdk.collaboraonline.com/docs/installation/CODE_Docker_image.html>
|
|
- 官方 Docker 镜像: <https://hub.docker.com/r/collabora/code>
|