VVCMS5 Logo
首页 / 使用指南 / 安装部署
安装部署

安装部署:Linux 部署(systemd + Nginx)

面向生产环境的推荐部署方式:独立用户运行 + systemd 守护 + Nginx 反向代理。

2026-03-04 0

适用场景

适用于 Ubuntu/Debian/CentOS/RHEL 等 Linux 服务器,推荐使用 systemd 管理进程,使用 Nginx 做反向代理与静态资源缓存。

1. 准备目录与用户

# 建议目录
mkdir -p /opt/vvcms5

# 创建运行用户(可选)
useradd -r -s /usr/sbin/nologin vvcms || true
chown -R vvcms:vvcms /opt/vvcms5

2. 上传程序与配置

将发布包解压到 /opt/vvcms5(示例:包含 app1configs/themes/static/)。

cd /opt/vvcms5
chmod +x app1
cp configs/config.yaml.example configs/config.yaml
# 按需修改:监听地址、数据库、日志路径等
vim configs/config.yaml

3. systemd 服务

# /etc/systemd/system/vvcms5.service
[Unit]
Description=VVcms Service
After=network.target

[Service]
Type=simple
User=vvcms
WorkingDirectory=/opt/vvcms5
ExecStart=/opt/vvcms5/app1 -t vvcms5
Restart=always
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl enable --now vvcms5
systemctl status vvcms5

4. Nginx 反向代理

server {
  listen 80;
  server_name your-domain.com;

  location /static/ {
    alias /opt/vvcms5/static/;
    expires 30d;
  }

  location / {
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

5. 初始化与验证

  1. 浏览器访问:http://your-domain.com
  2. 后台:http://your-domain.com/admin
  3. 后台进行“主题管理”并导入 init_data.json(如需演示数据)

常见问题

  • 启动失败:优先查看 journalctl -u vvcms5 -f 与应用日志
  • 端口不通:检查防火墙与监听地址(0.0.0.0:8000
  • 静态资源 404:确认 Nginx alias 目录正确