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

---
created: 2025-08-31T10:26
updated: 2025-08-31T10:47
---
以下是 **OnlyOffice Docs** 的 Docker 安装教程（社区版），支持文档在线编辑和协作：

---

### **1. 环境准备**
- **系统要求**：Linux/Windows/macOS（推荐 Linux）
- **Docker**：已安装 [Docker Engine](https://docs.docker.com/engine/install/) 和 [Docker Compose](https://docs.docker.com/compose/install/)
- **端口开放**：确保 `80`、`443`（或自定义端口）未被占用

---

### **2. 快速安装（单容器）**
#### **命令部署**
```bash
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` 文件：
```yaml
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
```

启动服务：
```bash
docker-compose up -d
```

---

### **4. 验证安装**
1. 访问 `http://服务器IP:8080`（或HTTPS端口）
2. 出现 **"ONLYOFFICE Docs is running"** 即成功
3. 测试文档编辑：点击页面中的 **"Create New"** 按钮

---

### **5. 配置Nginx反向代理（可选）**
```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设置中：
1. 安装 **"ONLYOFFICE"** 插件
2. 填写地址：`http://your-office-server:8080`
3. 输入 `JWT_SECRET`（需与Docker环境变量一致）

---

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

---

如果需要更详细的配置（如MySQL存储、集群部署），可以参考官方文档：  
[ONLYOFFICE Docker Documentation](https://helpcenter.onlyoffice.com/installation/docs-community-install-docker.aspx)  

建议将配置保存为笔记：  
```markdown
# [[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

#### 快速启动命令
```bash
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 示例
```yaml
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. 初始化配置**
1. **访问控制台**  
   安装完成后访问：  
   `http://服务器IP:8080/welcome/`  
   （HTTPS需配置SSL证书）

2. **验证服务状态**  
   ```bash
   docker exec onlyoffice-docs supervisorctl status
   ```
   正常应显示：  
   `docservice: RUNNING`  
   `converter: RUNNING`  
   `proxy: RUNNING`

---

### **4. 常见问题解决**
#### 🔴 端口冲突
错误表现：  
`Address already in use`  
解决方案：  
```bash
# 查看占用进程
sudo lsof -i :8080
# 修改映射端口（如改为8090）
docker run ... -p 8090:80 ...
```

#### 🟡 字体缺失
中文显示异常时：  
```bash
# 进入容器安装字体
docker exec -it onlyoffice-docs bash
apt update && apt install -y fonts-wqy-microhei
```

#### 🟢 性能优化
```yaml
# 在docker-compose.yml中添加资源限制
deploy:
  resources:
    limits:
      cpus: '2'
      memory: 4G
```

---

### **5. 进阶功能**
#### 集成Nextcloud/OwnCloud
1. 安装ONLYOFFICE插件  
2. 配置连接地址：  
   `https://your-server:8080/web-apps/apps/api/documents/api.js`

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

---

> 💡 **提示**：  
> - 如需HTTPS访问，推荐使用Nginx反向代理+Let's Encrypt证书  
> - 企业版需替换镜像为`onlyoffice/documentserver-ee`  

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

#### Sources:

- [[ONLYOFFICE 协作空间 3.0 新功能详解 - 知乎]]
- [[docker 日志清除命令 - 搜索]]