请注意：Next.js界面部署在同一个VPS服务器上，与管理服务器vGo一起。所有管理操作都通过“Kho Theme vGocms”界面直接执行。

观看安装指南视频 

主题操作指南

1. 运行时系统参数

根据Build status表，系统正以以下配置运行：

• 环境： Node.js (Next.js)。
• Workdir： data/theme_work/site_37（VPS上包含源代码的目录）。
• 端口： 4302（Next.js正在监听的内部端口）。
• 后端进程： systemd（Ubuntu的进程管理器）。
• Systemd单元： vgocms-theme-site-37.service（管理此主题的服务名称）。

2. 主题控制操作（左侧面板）

这些按钮直接与Next.js应用程序的源代码和生命周期交互。

• [保存env]：
  • 操作：仅将步骤3（环境变量、端口、后端进程）中的设置覆盖到配置文件中（例如，主题目录中的.env）。
  • 本质：纯粹的文件写入。不重新加载源代码（zip），不重新运行构建过程。
  • 注意：保存后，旧进程仍将使用旧配置运行。必须点击重启（如果是运行时env）或重建（如果是构建时env）才能应用。
• [重建]：
  • 操作：在现有源代码上重新运行Next.js构建流程。
  • 本质：执行npm ci（如果需要更新/重新安装node_modules）$\rightarrow$执行npm run build（或next build）。不从原始服务器重新加载zip文件。
  • 什么时候用：在直接在VPS上修改代码、有补丁更新或需要重新构建的环境变量发生更改时（例如NEXT_PUBLIC_...变量）。
• [重启]：
  • 操作：停止并重新启动当前的Node.js进程。
  • 本质：向 systemd 服务发送重启信号。非常快，因为不需要重新构建。
  • 何时使用：在点击“保存环境变量”后应用运行时 .env，或在进程挂起时清除内存（内存泄漏、卡死）。

3. Systemd 进程管理（右侧表格）

这些按钮直接执行 Ubuntu 的 systemctl 和 journalctl 命令，用于 unit vgocms-theme-site-37.service。需要主机上具有 root/sudo 权限。

• [状态]: 运行 systemctl status <unit>。返回服务的详细状态（正在运行、错误、崩溃...）。
• [是否活跃]: 运行 systemctl is-active <unit>。返回 active 或 inactive。
• [是否启用]: 运行 systemctl is-enabled <unit>。检查服务是否在 VPS 重启时自动启动。
• [启动]/[停止]/[重启]: 通过 systemd 基本命令以打开、关闭、重启服务。
• [启用]: 运行 systemctl enable <unit>。设置在 VPS 启动/重启时自动运行服务。
• [禁用]: 运行 systemctl disable <unit>。关闭自动运行配置。
• [日志]: 运行 journalctl -u <unit>。输出此 Next.js 进程的特定系统日志（console.log、错误日志、崩溃跟踪）。

4. LOG 表格（右下角）

显示正在运行的任务的实时输出。

• 示例图片中：保存配置时的标准流程 $\rightarrow$ 系统报告正在重启 $\rightarrow$ 启动成功。处理 bash/python 脚本过程中发生的任何错误（如果有）将在此处打印出来。