跳到主要内容

求助指南

1. 在 Gitee 仓库创建 issue​

2. 常见问题解答 (FAQ)​

2.2 Docker 安装失败怎么办？​

  • Linux/Mac： 确保命令以管理员权限执行（sudo）并检查网络连接。请参考官方安装指南。
  • Windows： 确认已启用 WSL 2 和 Hyper-V（需要 Windows 10/11 专业版）。家庭版用户需要手动配置 WSL 2。

2.3 下载配置文件时遇到 404 错误？​

  • 确认 Gitee 仓库 URL 正确无误，且文件 docker-compose.yml 和 .env 存在。
  • 临时解决方案： 通过复制仓库内容手动创建这些文件。

2.4 运行 docker-compose up -d 时提示 "Permission denied"（权限不足）？​

  • Linux： 运行 sudo usermod -aG docker $USER 然后注销/重新登录。
  • Mac/Windows： 确保 Docker Desktop 正在运行，并且您拥有适当的终端权限。

2.5 启动服务后无法访问 localhost:9898？​

  • 检查服务状态：docker-compose ps（所有服务应显示为 running 状态）。
  • 确认防火墙/杀毒软件没有阻止端口 9898。
  • 尝试清除浏览器缓存或使用无痕模式访问。

2.6 注册时提示 "组织已存在" 或 邮箱无效？​

  • 免费版本只能创建一个组织。
  • 组织名称必须唯一，请尝试不同的名称。
  • 确保邮箱格式有效（例如，user@example.com）。如果已经注册，请直接登录。

2.7 如何备份或迁移数据？​

  • 数据存储在 ./data 文件夹中。只需复制此文件夹即可进行备份。将其放置在新设备的相同路径下即可完成迁移。

2.8 如何更新到最新版本？​

# 拉取最新镜像并重启服务
docker-compose pull && docker-compose up -d

2.9 系统运行缓慢或崩溃？​

  • 确保您的设备满足最低要求（1GB 内存 + 1GB 磁盘空间）。
  • 使用 docker stats 监控资源使用情况。关闭不必要的应用程序以释放资源。