使用附加脚本参数安装 ONLYOFFICE 协作空间企业版
简介
ONLYOFFICE 协作空间企业版是一个付费文档中心，您可以将用户和文档连接在一个平台以提升协作效率。
ONLYOFFICE 协作空间企业版提供适用于已安装 Docker 的 Linux 操作系统的自动安装脚本。该脚本将配置包含 ONLYOFFICE 协作空间企业版正常运行所需全部组件的 Docker 容器，便于运行、管理和更新。
下载 ONLYOFFICE 协作空间企业版安装脚本后，您可能需要指定额外参数运行它，例如需将各组件安装到独立服务器时。
使用以下命令查看所有可用 Docker 脚本参数列表：
bash docspace-enterprise-install.sh docker -h使用以下命令查看所有可用 DEB/RPM 脚本参数列表：
bash docspace-enterprise-install.sh package -h下文提供这些参数的简要说明及使用示例。
带参数运行脚本时，系统将提示选择安装方式。输入 Y 并按 Enter 使用 Docker 安装，输入 N 并按 Enter 则通过 DEB/RPM 包安装。
凭证
| 参数 | 描述 |
|---|---|
-reg, --registry | docker 仓库URL（例如https://myregistry.com:5000） |
-un, --username | docker 仓库登录名 |
-p, --password | docker 仓库密码 |
当需要访问测试仓库运行容器时使用这些参数。
示例
bash docspace-enterprise-install.sh -reg URL -un username -p password安装类型
| 参数 | 描述 | 可选值 | 默认值 |
|---|---|---|---|
-it, --installation_type | 安装类型 | community|developer|enterprise | enterprise |
此参数用于安装指定版本：ONLYOFFICE 协作空间社区版、ONLYOFFICE 协作空间开发者版或 ONLYOFFICE 协作空间企业版。
示例
bash docspace-enterprise-install.sh -it community这将安装 ONLYOFFICE 协作空间社区版。
硬件检查
| 参数 | 描述 | 可选值 | 默认值 |
|---|---|---|---|
-skiphc, --skiphardwarecheck | 跳过硬件检查 | true|false | false |
此参数允许跳过系统最低硬件要求检查。
示例
bash docspace-enterprise-install.sh -skiphc true这将跳过硬件检查。
组件更新
| 参数 | 描述 | 可选值 | 默认值 |
|---|---|---|---|
-u, --update | 更新现有组件 | true|false | false |
当机器上安装的组件版本过旧时，此参数可安装最新版本的必要组件。
示例
bash docspace-enterprise-install.sh -u true这将停止需更新的容器，移除旧容器后运行最新版本组件。若当前版本与最新版一致则不受影响。先前安装跳过的组件仍将跳过。协作空间数据将自动迁移。
仅将文档服务更新至 7.2.1.34 版本并跳过其他组件：
bash docspace-enterprise-install.sh -u true -docsi onlyoffice/documentserver-ee -docsv 7.2.1.34 -idocs true -ids false -irbt false -irds false仅将协作空间更新至 1.2.0 版本并跳过其他组件：
bash docspace-enterprise-install.sh -u true -dsv v1.2.0 -idocs false -irbt false -irds false组件安装
| 参数 | 描述 | 可选值 | 默认值 |
|---|---|---|---|
-ids, --installdocspace | 安装 ONLYOFFICE 协作空间 | true|false | true |
-idocs, --installdocs | 安装 ONLYOFFICE 文档服务 | true|false | true |
-irbt, --installrabbitmq | 安装 RabbitMQ | true|false | true |
-irds, --installredis | 安装 Redis | true|false | true |
-imysql, --installmysql | 安装 MySQL | true|false | true |
这些参数指定是否安装特定组件，适用于多服务器分布式部署。
true：安装组件false：跳过组件安装
示例
bash docspace-enterprise-install.sh -idocs false这将安装除 ONLYOFFICE 文档服务外的全部组件。
bash docspace-enterprise-install.sh -ids false -idocs true -imysql false -irbt false -irds false这将跳过 ONLYOFFICE 协作空间、MySQL、RabbitMQ 和 Redis，仅安装 ONLYOFFICE 文档服务。
组件版本
| 参数 | 描述 |
|---|---|
-dsv, --docspaceversion | ONLYOFFICE 协作空间版本 |
-docsv, --docsversion | ONLYOFFICE 文档服务版本 |
当需要安装特定版本而非仓库最新版时使用这些参数。默认使用 latest 标签镜像运行容器。
示例
在浏览器中打开 Docker Hub 仓库，选择 ONLYOFFICE 文档服务并查看 Tags 选项卡中的可用版本标签。指定要安装的版本：
bash docspace-enterprise-install.sh -docsv 7.2.1.34这将安装带有 ONLYOFFICE 文档服务 7.2.1.34 版本的 ONLYOFFICE 协作空间。
ONLYOFFICE 文档服务镜像名称
| 参数 | 描述 |
|---|---|
-docsi, --docsimage | ONLYOFFICE 文档服务镜像名称 |
此参数指定容器启动所需的文档服务镜像名称。该镜像应存储于 Docker Hub 官方公共仓库。
示例
bash docspace-enterprise-install.sh -docsi onlyoffice/documentserver-ee这将从仓库中指定的 ONLYOFFICE 文档服务镜像运行容器。
主机设置
| 参数 | 描述 |
|---|---|
-dsh, --docspacehost | ONLYOFFICE 协作空间主机地址 |
-esh, --elastichost | Elasticsearch 主机地址 |
这些参数用于多服务器部署时连接组件。
示例
bash docspace-enterprise-install.sh -esh 192.168.3.202这将安装 ONLYOFFICE 协作空间并连接到位于IP地址 192.168.3.202 的独立服务器上的 Elasticsearch。
core.machinekey 设置
| 参数 | 描述 |
|---|---|
-mk, --machinekey | core.machinekey 密钥设置 |
此参数允许安装时指定自定义machinekey。
/app/onlyoffice/config/appsettings.json 配置文件（路径位于 onlyoffice-studio 容器内）。示例
bash docspace-enterprise-install.sh -mk yourmachinekeyONLYOFFICE 协作空间外部端口
| 参数 | 描述 | 默认值 |
|---|---|---|
-ep, --externalport | ONLYOFFICE 协作空间外部端口 | 80 |
此参数可修改 ONLYOFFICE 协作空间运行端口。默认使用80端口。
示例
bash docspace-enterprise-install.sh -ep 8080JWT头信息及密钥设置
| 参数 | 描述 |
|---|---|
-jh, --jwtheader | JWT 头信息设置 |
-js, --jwtsecret | JWT 密钥设置 |
这些参数允许安装时指定 JWT 头信息和自定义密钥。JWT 头信息定义传输 JWT 的 http 头，密钥用于签署 JSON Web 令牌并在请求文档服务时验证令牌。
- 协作空间：
/app/onlyoffice/config/appsettings.json - 文档服务：
/etc/onlyoffice/documentserver/local.json
示例
bash docspace-enterprise-install.sh -js yoursecretMySQL服务器
| 参数 | 描述 | 默认值 |
|---|---|---|
-mysqlrp, --mysqlrootpassword | MySQL root 账户密码 | my-secret-pw |
-mysqlh, --mysqlhost | MySQL 服务器主机 | localhost |
-mysqlport, --mysqlport | MySQL 服务器端口 | 3306 |
未显式指定时使用默认值。
示例
bash docspace-enterprise-install.sh -mysqlrp new-secret-pw此命令允许在安装过程中为 MySQL root 账户设置自定义密码。
ONLYOFFICE 协作空间数据库
| 参数 | 描述 | 默认值 |
|---|---|---|
-mysqld, --mysqldatabase | ONLYOFFICE 协作空间数据库名 | onlyoffice |
-mysqlu, --mysqluser | ONLYOFFICE 协作空间数据库用户 | onlyoffice_user |
-mysqlp, --mysqlpassword | ONLYOFFICE 协作空间数据库密码 | onlyoffice_pass |
这些参数允许创建自定义数据库名，并为该库设置具有超级用户权限的账户。未显式指定时使用默认值。
示例
bash docspace-enterprise-install.sh -mysqld docspacedatabase -mysqlu username -mysqlp password切换到 HTTPS
| 参数 | 描述 |
|---|---|
-led, --letsencryptdomain | Let's Encrypt 证书域名 |
-lem, --letsencryptmail | Let's Encrypt 证书管理员邮箱 |
-cf, --certfile | 域名证书文件路径 |
-ckf, --certkeyfile | 证书私钥文件路径 |
这些参数用于将门户切换至 HTTPS。仅适用于 Docker 版本。
示例
bash docspace-enterprise-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com这将自动创建并安装 letsencrypt.org CA签名证书，并重启 NGINX 服务生效。
bash docspace-enterprise-install.sh docker --certfile path --certkeyfile path这将应用自定义 SSL 证书。