Tronbyt-Server项目Docker部署指南

项目概述

Tronbyt-Server是一个基于Docker容器化部署的服务端应用，主要用于管理和渲染Pixlet应用。该项目通过Docker Compose文件定义了完整的服务配置，使得部署过程变得简单高效。

核心服务配置解析

Web服务定义

在docker-compose.yaml文件中，定义了一个名为web的核心服务：

services:
  web:
    image: ghcr.io/tavdog/tronbyt-server:latest
    restart: unless-stopped

• 镜像来源：使用最新版的tronbyt-server镜像
• 重启策略：配置为unless-stopped，意味着除非手动停止，否则容器会自动重启

端口映射配置

ports:
  - "${SERVER_PORT}:8000"
  - "${PIXLET_SERVE_PORT1}:5100"
  - "${PIXLET_SERVE_PORT2}:5101"

• 主服务端口：将容器内的8000端口映射到宿主机的SERVER_PORT环境变量指定端口
• Pixlet服务端口：
  • 5100端口用于Pixlet服务接口，映射到宿主机的PIXLET_SERVE_PORT1
  • 5101端口为第二个用户预留，映射到PIXLET_SERVE_PORT2
  • 注释说明可以按需增加更多用户端口或使用host网络模式

数据卷配置

volumes:
  - "/etc/localtime:/etc/localtime:ro"
  - users:/app/users
  - webp:/app/tronbyt_server/webp

• 时间同步：将宿主机的localtime文件以只读方式挂载到容器，确保容器时间与主机同步
• 用户数据卷：users卷挂载到/app/users目录，持久化存储用户数据
• WebP数据卷：webp卷挂载到/app/tronbyt_server/webp目录，存储WebP格式文件

环境变量配置

environment:
  - SERVER_HOSTNAME=${SERVER_HOSTNAME_OR_IP}
  - SERVER_PORT=${SERVER_PORT}
  - PIXLET_RENDER_PORT1=${PIXLET_SERVE_PORT1}
  - SYSTEM_APPS_REPO=${SYSTEM_APPS_REPO}
  - PRODUCTION=${PRODUCTION}

• 必需变量：SERVER_HOSTNAME_OR_IP必须设置，否则会报错
• 端口配置：SERVER_PORT和PIXLET_RENDER_PORT1与服务端口映射对应
• 应用仓库：SYSTEM_APPS_REPO指定系统应用的来源仓库
• 运行模式：PRODUCTION变量控制是否以生产模式运行

数据卷定义

volumes:
  users:
  webp:

在文件底部定义了命名的Docker卷，确保用户数据和WebP文件能够持久化存储。

部署实践建议

1. 环境准备：

   • 确保已安装Docker和Docker Compose
   • 创建.env文件并设置所有必需环境变量

2. 多用户支持：

   • 如需支持更多用户，可以按5100/5101的模式继续添加端口映射
   • 或者考虑使用host网络模式简化端口配置

3. 生产环境部署：

   • 将PRODUCTION环境变量设置为true
   • 考虑添加反向代理(如Nginx)处理HTTPS和负载均衡

4. 数据备份：

   • 定期备份users和webp卷数据
   • 可以考虑使用Docker卷的备份工具

常见问题排查

1. 时间不同步问题：

   • 检查/etc/localtime挂载是否正确
   • 验证主机时间设置

2. 端口冲突：

   • 确保SERVER_PORT、PIXLET_SERVE_PORT1等端口未被占用
   • 使用netstat -tuln检查端口使用情况

3. 环境变量缺失：

   • 特别是SERVER_HOSTNAME_OR_IP必须设置
   • 所有${}引用的变量都应在.env文件中定义

通过这份Docker Compose配置，Tronbyt-Server项目实现了开箱即用的容器化部署方案，既适合开发测试环境，也能满足生产部署需求。