域名、存储与 OnlyOffice

部署跑通后配置对外域名、文件存储（本地盘或 OSS）与可选 OnlyOffice。本文一屏写完，用右侧「本页目录」定位。

切域名 / HTTPS

1. DNS A 记录指向入口机；安全组 / 防火墙开放 443
2. 证书放到约定目录（如 /data/nginx/cert），Nginx 增加 listen 443 ssl
3. 同步修改：

项	位置
server_name	Nginx conf
文件配置「自定义域名」	见下文文件配置
OnlyOffice server-url	Document Server / 应用配置
UniApp 绝对 URL	env 后重建

文件配置入口

路径：基础设施 → 文件管理 → 文件配置。

列表支持本地盘、SFTP、数据库，以及多款 S3 对象存储（阿里云 OSS、腾讯云 COS、MinIO、华为云、七牛等）：

要点：

• 同一时间只有一条 主配置（红色「是」）生效；切换后点「+ 主配置」
• 改完建议点 测试，再在业务里上传验证
• 演示库里的云厂商配置多带「请换成你的密钥」备注，切勿直接用于生产

本地磁盘（单机推荐）

适合 Windows / Linux 单机、无对象存储合同的客户。

字段	Linux 建议	Windows 建议
存储器	本地磁盘	本地磁盘
基础路径	/data/app/upload	C:\ruoyi-office\upload
自定义域名	http://<SERVER_IP> 或 https://oa.example.com	http://<CLIENT_IP>

自定义域名 必须是浏览器能访问的地址，不要写 http://127.0.0.1:48080（局域网用户打不开）。设为主配置后上传一张小图，确认目录落盘且可预览。

OSS / S3 对象存储

合同要求对象存储时：新增或编辑一条配置，存储器选 S3 对象存储。

字段	说明
节点地址 endpoint	如 oss-cn-beijing.aliyuncs.com（MinIO 填自有 endpoint）
存储 bucket	桶名
accessKey / accessSecret	客户自有密钥；截图中的值为演示示例，生产必须替换
Path Style	阿里云 OSS 一般「禁用」；部分 MinIO 需「启用」
公开访问	按桶策略；常见「私有」+ 签名 URL
区域	多为 AWS 需要；阿里云可留空
自定义域名	桶公网域名或 CDN 域名（https://...）

配置后：

1. 点 测试
2. 设为 主配置
3. 业务上传 / 预览抽检
4. 密钥只放管理端或密封交付物，勿提交 Git

MinIO / 腾讯云 / 华为云等同样选「S3 对象存储」，按厂商填 endpoint 与 Path Style 即可。

OnlyOffice（可选）

• Nginx：proxy_pass 用 compose 服务名；反代 /onlyoffice/、/cache/、/coauthoring/（缺后两项会导致 Editor.bin 404）
• 切域名后更新 OO server-url 与回调可达性
• 未采购时可保持 yudao.onlyoffice.enabled: false

校验

• [ ] HTTPS 有效（若启用）
• [ ] 主配置正确（本地或 OSS）
• [ ] 上传成功且预览 URL 可访问
• [ ] OnlyOffice（若有）编辑与保存回调成功

侧栏继续：上线验收清单