StudyDiary/02-学习笔记/OnlyOffice安装教程.md at main

gtAdmin/StudyDiary

Fork 0

Files

T

CrazyJasonwell 513b68be8c first commit

2026-07-23 20:36:13 +08:00

5.9 KiB

Executable File

Raw Permalink Blame History

created, updated

created	updated
2025-08-31T10:26	2025-08-31T10:47

以下是 OnlyOffice Docs 的 Docker 安装教程（社区版），支持文档在线编辑和协作：

1. 环境准备

系统要求：Linux/Windows/macOS（推荐 Linux）
Docker：已安装 Docker Engine 和 Docker Compose
端口开放：确保 80、443（或自定义端口）未被占用

2. 快速安装（单容器）

命令部署

docker run -i -t -d -p 8080:80 --restart=always \
    -e JWT_ENABLED=false \  # 禁用JWT验证（测试用）
    -e JWT_SECRET=mysecretkey \  # 自定义JWT密钥（生产环境必设）
    --name onlyoffice-docs \
    onlyoffice/documentserver

参数说明：

-p 8080:80：将容器80端口映射到主机8080

JWT_ENABLED=false：关闭API验证（仅测试环境使用）

JWT_SECRET：生产环境必须设置复杂密钥

3. 生产环境推荐（Docker Compose）

创建 docker-compose.yml 文件：

version: '3'
services:
  onlyoffice:
    image: onlyoffice/documentserver
    container_name: onlyoffice
    restart: always
    ports:
      - "443:443"
    volumes:
      - ./onlyoffice/data:/var/www/onlyoffice/Data  # 数据持久化
      - ./onlyoffice/logs:/var/log/onlyoffice       # 日志持久化
    environment:
      - JWT_SECRET=your_strong_password_here

启动服务：

docker-compose up -d

4. 验证安装

访问 http://服务器IP:8080（或HTTPS端口）
出现 "ONLYOFFICE Docs is running" 即成功
测试文档编辑：点击页面中的 "Create New" 按钮

5. 配置Nginx反向代理（可选）

server {
    listen 80;
    server_name office.yourdomain.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

建议配置HTTPS证书（Let's Encrypt）

6. 常见问题

问题	解决方案
启动失败	检查端口冲突：`netstat -tulnp \| grep 8080`
文档无法保存	确保 `/var/www/onlyoffice/Data` 目录有写入权限
连接超时	防火墙放行端口：`sudo ufw allow 8080`

7. 集成到Nextcloud/OwnCloud

在Nextcloud设置中：

安装 "ONLYOFFICE" 插件
填写地址：http://your-office-server:8080
输入 JWT_SECRET（需与Docker环境变量一致）

8. 升级/卸载

升级：docker pull onlyoffice/documentserver 后重启容器
卸载：docker rm -f onlyoffice-docs + 删除挂载卷

如果需要更详细的配置（如MySQL存储、集群部署），可以参考官方文档：
ONLYOFFICE Docker Documentation

建议将配置保存为笔记：

# [[OnlyOffice部署记录]]  
- 安装时间：<% tp.date.now("YYYY-MM-DD") %>  
- 访问地址：http://your-server-ip:8080  
- JWT密钥：||加密存储||

【第二次结果】

以下是 ONLYOFFICE Docs Docker 安装教程（最新社区版），包含常见问题解决方案：

1. 基础安装

最低系统要求

2核CPU / 4GB内存 / 20GB硬盘
Docker Engine 20.10+ 和 Docker Compose

快速启动命令

docker run -i -t -d -p 8080:80 --restart=always \
  -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice  \
  -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data  \
  -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
  --name onlyoffice-docs \
  onlyoffice/documentserver:7.4

2. 生产环境配置

docker-compose.yml 示例

version: '3'
services:
  onlyoffice:
    image: onlyoffice/documentserver:7.4
    container_name: onlyoffice
    restart: always
    ports:
      - "8443:443"
    volumes:
      - ./data:/var/www/onlyoffice/Data
      - ./logs:/var/log/onlyoffice
      - ./lib:/var/lib/onlyoffice
    environment:
      - JWT_ENABLED=true
      - JWT_SECRET=your_strong_password

关键参数说明

参数	作用	示例值
`JWT_ENABLED`	启用API安全验证	`true`
`JWT_SECRET`	签名密钥（至少16字符）	`MySuperSecretKey123!`
`DB_TYPE`	数据库类型（默认SQLite）	`postgres`

3. 初始化配置

访问控制台
安装完成后访问：
http://服务器IP:8080/welcome/
（HTTPS需配置SSL证书）
验证服务状态
```
docker exec onlyoffice-docs supervisorctl status
```
正常应显示：
docservice: RUNNING
converter: RUNNING
proxy: RUNNING

4. 常见问题解决

🔴 端口冲突

错误表现：
Address already in use
解决方案：

# 查看占用进程
sudo lsof -i :8080
# 修改映射端口（如改为8090）
docker run ... -p 8090:80 ...

🟡 字体缺失

中文显示异常时：

# 进入容器安装字体
docker exec -it onlyoffice-docs bash
apt update && apt install -y fonts-wqy-microhei

🟢 性能优化

# 在docker-compose.yml中添加资源限制
deploy:
  resources:
    limits:
      cpus: '2'
      memory: 4G

5. 进阶功能

集成Nextcloud/OwnCloud

安装ONLYOFFICE插件
配置连接地址：
https://your-server:8080/web-apps/apps/api/documents/api.js

备份策略

# 定期备份数据卷
tar -czvf onlyoffice_backup_$(date +%F).tar.gz /app/onlyoffice

💡 提示：

如需HTTPS访问，推荐使用Nginx反向代理+Let's Encrypt证书

企业版需替换镜像为onlyoffice/documentserver-ee

需要更详细的Nginx配置或集群部署方案吗？

5.9 KiB Executable File Raw Permalink Blame History Unescape Escape