使用附加脚本参数安装 ONLYOFFICE Apps社区版
简介
ONLYOFFICE Apps社区版是文档中心的免费版本，您可以在一处连接用户和文档，以促进协作。
ONLYOFFICE Apps社区版以适用于已安装 Docker 的 Linux 操作系统的自动安装脚本形式提供。该脚本将设置包含 ONLYOFFICE Apps社区版正常运行所需所有组件的 Docker 容器，并且易于运行、管理和更新。
下载 ONLYOFFICE Apps社区版安装脚本后，您可能需要指定一些附加参数来运行它，例如，如果您想将每个组件安装在单独的计算机上。
使用以下命令显示所有可用 Docker 脚本参数的列表：
bash apps-install.sh docker -h
使用以下命令显示所有可用 DEB/RPM 脚本参数的列表：
bash apps-install.sh package -h
您可以在下方找到这些参数的简短说明和一些使用示例。
使用参数运行脚本时，系统会提示您选择安装 ONLYOFFICE Apps的方式。输入 Y 并按 Enter 键，使用 Docker 安装 ONLYOFFICE Apps。输入 N 并按 Enter 键，从 DEB/RPM 软件包安装 ONLYOFFICE Apps。
凭证
| 参数 | 描述 |
|---|---|
-reg, --registry | Docker 注册表 URL（例如 https://myregistry.com:5000） |
-un, --username | Docker 注册表登录名 |
-p, --password | Docker 注册表密码 |
如果我们向您提供了访问测试存储库的凭证，则会使用这些参数，以便您可以从其中存储的镜像运行容器。
示例
bash apps-install.sh -reg URL -un username -p password
安装类型
| 参数 | 描述 | 取值 | 默认值 |
|---|---|---|---|
-it, --installationtype | 安装类型 | community|developer|enterprise | community |
此参数允许您安装指定的解决方案：ONLYOFFICE Apps社区版、ONLYOFFICE Apps开发者版或 ONLYOFFICE Apps企业版。
示例
bash apps-install.sh -it enterprise
这将安装 ONLYOFFICE Apps企业版解决方案。
硬件检查
| 参数 | 描述 | 取值 | 默认值 |
|---|---|---|---|
-skiphc, --skiphardwarecheck | 用于跳过硬件检查 | true|false | false |
此参数允许您跳过检查系统是否满足最低硬件要求。
示例
bash apps-install.sh -skiphc true
这将跳过硬件检查。
组件更新
| 参数 | 描述 | 取值 | 默认值 |
|---|---|---|---|
-u, --update | 用于更新现有组件 | true|false | false |
如果您计算机上安装的相应组件已过时，此参数允许您安装所需组件的最新版本。
示例
bash apps-install.sh -u true
这将依次停止需要更新的容器，删除它们，然后运行相应 ONLYOFFICE Apps社区版组件的最新版本。如果当前组件版本与最新可用版本一致，则该容器不会受到影响。如果您在上次安装期间跳过了某些组件，这些组件也将被跳过。ONLYOFFICE Apps 数据应会自动获取。
仅将 Docs 更新到 7.2.1.34 版本，并跳过所有其他组件的更新：
bash apps-install.sh -u true -docsi onlyoffice/documentserver -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false
仅将 ONLYOFFICE Apps 更新到 1.2.0 版本，并跳过所有其他组件的更新：
bash apps-install.sh -u true -asv v1.2.0 -idocs false -irbt false -irds false
组件安装
| 参数 | 描述 | 取值 | 默认值 |
|---|---|---|---|
-ia, --installapps | 安装 ONLYOFFICE Apps | 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 apps-install.sh -idocs false
这将安装 ONLYOFFICE Apps社区版的所有组件，但不包括 ONLYOFFICE 文档。
bash apps-install.sh -ia false -idocs true -imysql false -irbt false -irds false
这将跳过 ONLYOFFICE Apps、MySQL、RabbitMQ 和 Redis 的安装，仅安装 ONLYOFFICE 文档。
组件版本
| 参数 | 描述 |
|---|---|
-asv, --appsversion | ONLYOFFICE Apps版本 |
-docsv, --docsversion | ONLYOFFICE 文档版本 |
如果出于某些原因您不想安装存储库中可用的最新版本，可以使用这些参数安装特定版本的 ONLYOFFICE Apps或 ONLYOFFICE 文档。默认情况下，使用标记为 latest 的镜像来运行组件容器。
示例
在浏览器中打开 Docker Hub 存储库，选择 ONLYOFFICE Docs，然后转到 Tags 选项卡查看存储库中所有可用的标签。指定您要安装的版本：
bash apps-install.sh -docsv 7.2.1.34
这将安装 ONLYOFFICE Apps，并使用 ONLYOFFICE 文档 7.2.1.34 版本。
ONLYOFFICE 文档镜像名称
| 参数 | 描述 |
|---|---|
-docsi, --docsimage | ONLYOFFICE 文档镜像名称 |
此参数可用于指定启动容器所用的 ONLYOFFICE 文档镜像名称。指定的镜像应存储在我们位于 Docker Hub 的官方公共存储库中。
示例
bash apps-install.sh -docsi onlyoffice/documentserver
这将从存储库中存储的指定 ONLYOFFICE 文档镜像运行容器。
主机设置
| 参数 | 描述 |
|---|---|
-ash, --appshost | ONLYOFFICE Apps主机 |
-esh, --elastichost | OpenSearch 主机 |
如果您将组件安装在不同的计算机上，可以使用这些参数连接组件。
示例
bash apps-install.sh -esh 192.168.3.202
这将安装 ONLYOFFICE Apps，并将其与安装在另一台 IP 地址为 192.168.3.202 的计算机上的 OpenSearch 连接。
core.machinekey 设置
| 参数 | 描述 |
|---|---|
-mk, --machinekey | core.machinekey 密钥设置 |
此参数允许您在安装 ONLYOFFICE Apps社区版时指定自己的 machinekey。
此参数会写入 /app/onlyoffice/config/appsettings.json 配置文件（路径在 onlyoffice-studio 容器内指定）。
示例
bash apps-install.sh -mk yourmachinekey
ONLYOFFICE Apps外部端口
| 参数 | 描述 | 默认值 |
|---|---|---|
-ep, --externalport | ONLYOFFICE Apps外部端口 | 80 |
此参数允许您更改 ONLYOFFICE Apps运行所用的端口。默认情况下使用 80 端口。
示例
bash apps-install.sh -ep 8080
JWT 头信息和密钥设置
| 参数 | 描述 |
|---|---|
-jh, --jwtheader | JWT 头信息设置 |
-js, --jwtsecret | JWT 密钥设置 |
这些参数允许您在安装 ONLYOFFICE Apps社区版时指定 JWT 头信息和您自己的 JWT 密钥。JWT 头信息定义用于发送 JWT 的 http 头。密钥用于对 JSON Web 令牌进行签名，并在向 ONLYOFFICE 文档发出请求时验证令牌。
这些参数会写入以下配置文件（路径在 onlyoffice-studio 和 onlyoffice-document-server 容器内指定）：
- ONLYOFFICE Apps -
/app/onlyoffice/config/appsettings.json - 文档服务器 -
/etc/onlyoffice/documentserver/local.json
示例
bash apps-install.sh -js yoursecret
MySQL 服务器
| 参数 | 描述 | 默认值 |
|---|---|---|
-mysqlrp, --mysqlrootpassword | MySQL 服务器 root 密码 | 自动生成 |
-mysqlh, --mysqlhost | MySQL 服务器主机 | localhost |
-mysqlport, --mysqlport | MySQL 服务器端口号 | 3306 |
如果您未明确指定主机和端口，则使用默认值。如果您未设置 root 密码，则会自动生成。
示例
bash apps-install.sh -mysqlrp new-secret-pw
此命令允许您在安装 ONLYOFFICE Apps社区版期间为 MySQL root 账户设置自己的密码。
ONLYOFFICE ONLYOFFICE Apps 数据库
| 参数 | 描述 | 默认值 |
|---|---|---|
-mysqld, --mysqldatabase | ONLYOFFICE Apps数据库名称 | onlyoffice_apps |
-mysqlu, --mysqluser | ONLYOFFICE Apps数据库用户 | - |
-mysqlp, --mysqlpassword | ONLYOFFICE Apps数据库密码 | 自动生成 |
这些参数允许您创建 ONLYOFFICE Apps数据库，可指定自定义数据库名称，以及对所创建数据库具有超级用户权限的账户的用户名和密码。如果您未明确指定数据库名称，则使用默认值。如果您未设置密码，则会自动生成。
示例
bash apps-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password
RabbitMQ 服务器
| 参数 | 描述 | 默认值 |
|---|---|---|
--rabbitmqprotocol | RabbitMQ 连接协议 | amqp |
--rabbitmqhost | RabbitMQ 服务器主机 | localhost |
--rabbitmqport | RabbitMQ 服务器端口号 | 5672 |
--rabbitmqusername | RabbitMQ 用户名 | - |
--rabbitmqpassword | RabbitMQ 用户密码 | - |
--rabbitmqvirtualhost | RabbitMQ 虚拟主机 | / |
使用这些参数将 ONLYOFFICE Apps 连接到已在另一台计算机上运行的 RabbitMQ 服务器。使用 -irbt false 参数跳过 RabbitMQ 的安装，然后指定您自己服务器的连接参数。如果您未明确指定协议、主机、端口或虚拟主机，则使用默认值。
示例
bash apps-install.sh -irbt false --rabbitmqhost mq.example.com --rabbitmqusername username --rabbitmqpassword password
这将安装不含 RabbitMQ 的 ONLYOFFICE Apps，并将其连接到在 mq.example.com 主机上运行的 RabbitMQ 服务器。
Redis 服务器
| 参数 | 描述 | 默认值 |
|---|---|---|
--redishost | Redis 服务器主机 | localhost |
--redisport | Redis 服务器端口号 | 6379 |
--redisusername | Redis 用户名（如果服务器需要授权） | - |
--redispassword | Redis 用户密码（如果服务器需要授权） | - |
使用这些参数将 ONLYOFFICE Apps 连接到已在另一台计算机上运行的 Redis 服务器。使用 -irds false 参数跳过 Redis 的安装，然后指定您自己服务器的连接参数。只有在您的 Redis 服务器需要授权时，才需要用户名和密码。
示例
bash apps-install.sh -irds false --redishost redis.example.com --redispassword password
这将安装不含 Redis 的 ONLYOFFICE Apps，并将其连接到在 redis.example.com 主机上运行的 Redis 服务器。
OpenSearch 服务器
| 参数 | 描述 | 默认值 |
|---|---|---|
--elasticprotocol | OpenSearch 连接协议 | http |
--elasticport | OpenSearch 服务器端口号 | 9200 |
将这些参数与上面 主机设置 部分中介绍的 -esh, --elastichost 参数一起使用，可将 ONLYOFFICE Apps 连接到在另一台计算机上运行的 OpenSearch 服务器。如果您未明确指定协议和端口，则使用默认值。
示例
bash apps-install.sh -esh search.example.com --elasticprotocol https --elasticport 9200
这将通过 HTTPS 将 ONLYOFFICE Apps 连接到在 search.example.com 主机上运行的 OpenSearch 服务器。
切换到 HTTPS
| 参数 | 描述 |
|---|---|
-led, --letsencryptdomain | 定义 Let's Encrypt 证书的域名 |
-lem, --letsencryptmail | 定义 Let's Encrypt 证书的域名管理员邮箱地址 |
-cf, --certfile | 域名证书文件的路径 |
-ckf, --certkeyfile | 证书私钥文件的路径 |
这些参数允许您将工作区切换到 HTTPS。它们仅可用于 Docker 版本。
示例
bash apps-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com
这将自动创建由 letsencrypt.org CA 签名的证书并安装到您的服务器上，然后重启 NGINX 服务以使更改生效。
bash apps-install.sh docker --certfile path --certkeyfile path
这将应用您自己的 SSL 证书。