vGocms Core 详细安装指南

系统要求

运行 Ubuntu 20.04 或 22.04 的 VPS/服务器。
已安装 aaPanel。
aaPanel 上的软件：Nginx、MariaDB、Redis、Supervisor 管理器。
推荐使用最新版 MariaDB 代替 MySQL。

步骤 1：下载源码与权限设置

访问 aaPanel 的文件管理。创建根目录：

/www/wwwroot/vgocms.com

通过以下链接下载并解压最新版本：Download Zip。

为 vgocms_linux_amd64 授予执行权限 755：

aaPanel 界面：右键文件 -> 权限。勾选“执行”。所有者设为 www。应用。
终端/SSH：

chmod +x /www/wwwroot/vgocms.com/vgocms_linux_amd64

步骤 2：安装 Node.js（主题必需）

编译前端资源需要 Node.js。在软件商店安装 Node.js 版本管理器。

安装 Stable Version，版本 v20 或更高，并在“命令行版本”中将其设为默认。

步骤 3：初始化 MariaDB 数据库与检查 Redis

为了优化 vGocms 性能，请使用最新版本的 MariaDB 代替旧版 MySQL。如果需要，您可以在同一台服务器上同时运行 MariaDB 和 MySQL。

进入 Databases -> Add database。

安全提示：不要使用 root 账户或简单密码。请创建专门的数据库和用户，并使用强密码。

例如：

数据库名称：vgocms_db。
用户：vgocms_user。
密码：使用强密码。

确保 Redis 在端口 6379 运行。如有密码，请记录。

步骤 4：环境变量 (.env)

编辑 .env 文件。模板中提供的值，例如 root 或 123456，仅为示例。请用您在步骤 3 中创建的实际凭据替换。

重要提示：

SESSION_SECRET：必须改为长随机字符串。
APP_PORT：内部端口，默认 8000。

# --- Database (TEMPLATE ONLY - DO NOT USE root/123456 in production) ---
DB_HOST=localhost
DB_PORT=3306
DB_USER=your_secure_db_user
DB_PASS=your_secure_password
DB_NAME=your_db_name

# --- Redis ---
REDIS_ADDR=localhost:6379
REDIS_PASS=
REDIS_DB=0

# --- User Microservice Integration ---
USER_SERVICE_BASE_URL=http://localhost:8081
USER_SERVICE_WEBHOOK_ENABLED=1
USER_SERVICE_WEBHOOK_SECRET=123456

# --- Session ---
SESSION_SECRET=change_this_to_a_very_long_random_string_in_production

# --- Application ---
APP_PORT=8000
GIN_MODE=release

步骤 5：使用 Supervisor 管理器运行服务

打开 Supervisor 管理器 -> 添加守护进程。

名称：vgocms_core
运行用户：www
运行目录：/www/wwwroot/vgocms.com
启动命令：/www/wwwroot/vgocms.com/vgocms_linux_amd64

步骤 6：配置反向代理 (Nginx)

在 aaPanel 添加网站。进入 反向代理 -> 添加。

目标 URL：

http://localhost:8000

安装 Let's Encrypt SSL。

步骤 7：管理员登录与安全

安装完成后，通过以下地址访问后台：

http://yourdomain.com/admin/login

默认账号：[email protected]

密码：admin123

安全建议：首次登录后，请立即修改管理员邮箱和密码。您还可以在设置中更改 /admin 路径，以防止暴力破解。

详细的在Ubuntu VPS上安装vGocms核心的指南