Docker 部署 ShowDoc

以下是使用 Docker 部署 ShowDoc 的详细步骤，适用于快速搭建文档管理系统：

---

1. 准备工作

• 确保已安装 Docker 和 Docker Compose（官方安装指南）。
• 开放 80 端口（或自定义端口）供外部访问。

---

2. 快速部署（单命令运行）

docker run -d --name showdoc \
  -p 4999:80 \
  -v /your/local/path:/var/www/html/ \
  star7th/showdoc

参数说明：

• -p 4999:80：将容器 80 端口映射到宿主机的 4999 端口（可改为 80:80 直接使用默认 HTTP 端口）。
• -v /your/local/path：挂载本地目录持久化数据（如 /data/showdoc）。

---

3. 使用 Docker Compose（推荐）

创建 docker-compose.yml 文件：

version: '3'
services:
  showdoc:
    image: star7th/showdoc
    container_name: showdoc
    ports:
      - "4999:80"
    volumes:
      - /your/local/path:/var/www/html/
    restart: unless-stopped

启动服务：

docker-compose up -d

---

4. 访问 ShowDoc

• 浏览器访问 http://服务器IP:4999。
• 首次运行会自动跳转到安装页面，按提示完成初始化（数据库会自动配置，无需额外操作）。

---

5. 配置 HTTPS（可选）

通过 Nginx 反向代理并配置 SSL 证书：

server {
    listen 443 ssl;
    server_name doc.yourdomain.com;
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

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

---

6. 数据备份

• 备份数据：直接复制挂载的本地目录（/your/local/path）。
• 恢复数据：将备份文件放回挂载目录，重启容器即可。

---

常见问题

1. 端口冲突：修改 -p 参数中的宿主机端口（如 8080:80）。
2. 权限问题：确保挂载目录可写：

   chmod -R 777 /your/local/path
   

3. 更新版本：

   docker-compose pull && docker-compose up -d
   

---

总结

• 使用 Docker 部署 ShowDoc 仅需 1 条命令，适合快速搭建。
• 通过 volumes 挂载数据目录可保证持久化存储。
• 生产环境建议搭配 Nginx 和 HTTPS 提升安全性。

如需更复杂的配置（如独立 MySQL），可参考 ShowDoc 官方文档。