Skip to main content

🐳 使用 Docker 部署

快速开始

在开始部署之前，建议先阅读《写在前面》，快速了解 RollCode 的基本信息。

前置准备​

环境要求​

重要提示

建议按照 Docker 官方文档进行安装，因为部分 Linux 发行版的软件仓库中的 Docker 版本可能较旧。

🚀 部署步骤​

1. 创建项目目录​

创建并进入项目目录

mkdir ~/rollcode && cd ~/rollcode
数据存储说明

所有 RollCode 的数据都将保存在此目录中，请确保妥善保管。

2. 部署 RollCode​

拉取最新版本的 RollCode 镜像

docker pull rollcode/rollcode:beta

创建并启动 RollCode 容器

docker run -d \
  --name rollcode \
  -p 8080:8080 \
  -v ~/rollcode/.rollcode_data:/app/data \
  rollcode/rollcode:beta

3. 配置说明​

参数说明示例值
--name容器名称rollcode
-p端口映射8080:8080
-v数据卷映射~/rollcode/.rollcode_data:/app/data
端口说明
  • 8080: RollCode 服务端口

4. 激活 RollCode​

完成服务启动后，请按照激活指南完成 RollCode 的激活。

🔧 常用命令​

查看容器状态
# 查看容器运行状态
docker ps -a | grep rollcode

# 查看容器日志
docker logs -f rollcode
管理容器
# 停止容器
docker stop rollcode

# 启动容器
docker start rollcode

# 重启容器
docker restart rollcode

# 删除容器
docker rm -f rollcode
更新 RollCode
# 停止并删除旧容器
docker stop rollcode
docker rm rollcode

# 拉取新版本镜像
docker pull rollcode/rollcode:beta

# 创建新容器
docker run -d \
  --name rollcode \
  -p 8080:8080 \
  -v ~/rollcode/data:/app/data \
  rollcode/rollcode:beta

📚 数据备份​

备份建议

建议定期备份 ~/rollcode/.rollcode_data（具体目录视根据具体情况）工作目录，以防数据丢失。

# 备份数据
cp -r ~/rollcode/.rollcode_data ~/rollcode/data_backup_$(date +%Y%m%d)

# 恢复数据
cp -r ~/rollcode/data_backup_20240101/* ~/rollcode/rollcode_data

🔍 常见问题​

容器无法启动怎么办？
  1. 检查端口占用：
lsof -i :8080
  1. 检查日志：
docker logs rollcode
  1. 检查数据目录权限：
ls -l ~/rollcode/data
如何修改配置？
  1. 停止容器
  2. 修改配置文件
  3. 重新启动容器
docker stop rollcode
# 修改配置文件
docker start rollcode

📚 相关文档​