topfans/backend/deploy

deploy/ 目录说明

本目录包含 TopFans 后端的生产部署配置模板，采用分层环境变量策略管理多服务配置。

目录结构

deploy/
├── envs/                   # 环境变量模板（按服务拆分）
│   ├── common.env          # 所有服务共享（DB、日志级别等）
│   ├── user.env            # User Service 私有配置
│   ├── social.env          # Social Service 私有配置
│   ├── gallery.env         # Gallery Service 私有配置
│   ├── asset.env           # Asset Service 私有配置（含 OSS）
│   ├── activity.env        # Activity Service 私有配置
│   └── gateway.env         # Gateway 私有配置（含 JWT、下游地址）
└── systemd/                # systemd 服务文件模板
    ├── topfans-user.service
    ├── topfans-social.service
    ├── topfans-gallery.service
    ├── topfans-asset.service
    ├── topfans-activity.service
    └── topfans-gateway.service

服务端口

服务	端口
Gateway	8080
User Service	20000
Gallery Service	20001
Social Service	20002
Asset Service	20003
Activity Service	20004

配置优先级

CLI flag > 环境变量（ENV） > 代码硬编码默认值

各服务 main.go 中的 flag 默认值均从对应环境变量读取，因此：

• 单机部署: 只需填写 /etc/topfans/*.env，无需传任何启动参数
• 多机部署: 仅修改目标服务器上的 env 文件中的地址，代码不变

快速部署步骤

1. 安装配置文件

# 创建服务器上的配置目录
sudo mkdir -p /etc/topfans
sudo chown topfans:topfans /etc/topfans
sudo chmod 750 /etc/topfans

# 复制模板并按实际环境修改
sudo cp deploy/envs/common.env  /etc/topfans/common.env
sudo cp deploy/envs/user.env    /etc/topfans/user.env
sudo cp deploy/envs/social.env  /etc/topfans/social.env
sudo cp deploy/envs/gallery.env /etc/topfans/gallery.env
sudo cp deploy/envs/asset.env   /etc/topfans/asset.env
sudo cp deploy/envs/activity.env /etc/topfans/activity.env
sudo cp deploy/envs/gateway.env /etc/topfans/gateway.env

# 填写真实密码、OSS 密钥、JWT Secret 等
sudo vim /etc/topfans/common.env
sudo vim /etc/topfans/asset.env
sudo vim /etc/topfans/gateway.env

# 保护文件权限
sudo chmod 640 /etc/topfans/*.env
sudo chown topfans:topfans /etc/topfans/*.env

2. 安装 systemd 服务文件

sudo cp deploy/systemd/*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable topfans-user topfans-gallery topfans-social \
                       topfans-asset topfans-activity topfans-gateway

3. 编译并启动

# 编译（输出到 /opt/topfans/）
cd gateway         && go build -ldflags="-s -w" -o /opt/topfans/gateway .
cd services/userService     && go build -ldflags="-s -w" -o /opt/topfans/user-service .
cd services/galleryService  && go build -ldflags="-s -w" -o /opt/topfans/gallery-service .
cd services/socialService   && go build -ldflags="-s -w" -o /opt/topfans/social-service .
cd services/assetService    && go build -ldflags="-s -w" -o /opt/topfans/asset-service .
cd services/activityService && go build -ldflags="-s -w" -o /opt/topfans/activity-service .

# 按依赖顺序启动
sudo systemctl start topfans-user topfans-asset
sudo systemctl start topfans-gallery topfans-social topfans-activity
sudo systemctl start topfans-gateway

多机部署

只需修改目标服务器上的 env 文件，将 localhost 替换为对应服务器的内网 IP：

# 示例：应用服务器1 上的 gateway.env，Asset/Gallery 在应用服务器2（10.0.0.21）
DUBBO_GALLERY_SERVICE_URL=tri://10.0.0.21:20001
DUBBO_ASSET_SERVICE_URL=tri://10.0.0.21:20003

详细步骤参见 docs/服务器部署指南.md。

注意事项

• 不要将真实密钥提交到 Git，/etc/topfans/*.env 应仅存在于服务器本地
• deploy/envs/*.env 中的值仅为示例模板，提交到仓库时不应包含真实密码
• deploy/systemd/*.service 假设二进制位于 /opt/topfans/，如部署路径不同请修改 WorkingDirectory 和 ExecStart