240 lines
5.9 KiB
Markdown
Executable File
240 lines
5.9 KiB
Markdown
Executable File
---
|
||
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 日志清除命令 - 搜索]] |