一、准备宝塔面板环境

宝塔面板能简化服务器管理与项目部署流程，是本次部署的核心工具，需先完成安装与初始化。

  1. 首先通过主机商获取服务器的SSH登录信息（IP地址、端口、密码/密钥），使用Xshell、Putty等SSH工具登录服务器。
  2. 登录成功后，切换至root权限（若已为root用户可跳过），执行以下一键安装命令：
  3. if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ssl251104
  4. 执行命令后，终端会提示确认安装，输入y并回车，等待2~10分钟（安装时长取决于服务器配置与网络速度）。
  5. 安装完成后，终端会输出宝塔面板的登录地址、账号和密码，务必妥善保存，后续将通过该地址访问面板。
注意：安装过程中请勿中断终端连接，若安装失败可重新执行上述命令重试；建议安装完成后立即修改宝塔面板默认密码，提升安全性。

二、克隆项目仓库并安装依赖

本步骤分为后端、前端用户端、前端管理端三部分，需分别完成仓库克隆与依赖安装，确保各模块能正常运行。

（一）后端安装

  1. 在SSH终端或宝塔面板的终端工具中，进入任意自定义目录（建议选择容量充足、路径简洁的目录，如/www），执行以下命令克隆项目仓库：
  2. git clone https://gitee.com/wuaxcn/nacrbbs.git
  3. 克隆完成后，进入项目根目录：cd /nacrbbs（若自定义了存放目录，需修改路径为实际目录，如cd /www/nacrbbs）。
  4. 执行依赖安装命令：npm i，等待依赖安装完成（过程中若出现警告可忽略，若报错需检查Node版本或网络环境）。
  5. 依赖安装完成后，进入配置文件目录：cd /app/config，修改目录下的Redis和MySQL配置文件，将其中的连接信息（如数据库地址、账号、密码，Redis地址、密码）替换为自己服务器的实际信息。
提示：MySQL默认端口为3306，Redis默认端口为6379，若服务器修改过默认端口，需同步更新配置文件中的端口信息，否则无法正常连接。

（二）前端用户端依赖安装

  1. 在终端中，从项目根目录进入前端用户端目录：cd /web/client（路径需与实际项目存放路径对应）。
  2. 执行依赖安装命令：npm i，等待安装完成，期间避免中断操作。

（三）前端管理端依赖安装

  1. 依赖安装完成后，进入前端管理端目录：cd /web/admin（同样需对应实际项目路径）。
  2. 执行依赖安装命令：npm i，等待安装完成，确保无报错信息。

三、添加宝塔项目并管理

通过宝塔面板的Node项目管理功能，统一配置后端、前端用户端、前端管理端，完成项目启动与端口设置，实现一站式管理。

（一）前置准备：安装指定版本Node.js

  1. 登录宝塔面板，进入「网站」-「Node项目」页面。
  2. 点击页面中的「安装Node.js」，选择18.x及以上版本（建议安装18.x稳定版），安装完成后设置命令行版本为该版本，确保全局Node版本统一。

（二）添加后端项目

  1. 在Node项目页面点击「添加项目」，项目路径选择NaCl项目的根目录（如/nacrbbs）。
  2. 启动命令填写：/sd2/nacrbbs/index.js（需确认路径与实际项目存放位置一致，若路径有误将无法启动）。
  3. 由于前文已手动安装完依赖，无需勾选「安装依赖」选项；启动方式选择「npm」，请勿选择pnpm（避免依赖兼容问题）。
  4. 点击「保存」后，系统将自动启动后端项目，默认启动端口为9999，该端口无需对外开放（仅用于内部通信）。

（三）添加前端用户端项目

  1. 再次点击「添加项目」，项目路径选择前端用户端目录：/web/client（对应实际路径）。
  2. 启动方式选择第二个选项（通常为npm run dev或对应启动命令，以面板显示为准），无需勾选「安装依赖」，启动方式选择「npm」。
  3. 保存后项目自动启动，默认端口为3001，该端口需对外开放（需在服务器安全组和宝塔防火墙中放行3001端口），后续可绑定域名方便访问。

（四）添加前端管理端项目

  1. 点击「添加项目」，项目路径选择前端管理端目录：/web/admin（对应实际路径）。
  2. 启动方式选择第二个选项，无需勾选「安装依赖」，启动方式选择「npm」。
  3. 保存后项目自动启动，默认端口为3000，该端口需对外开放（放行3000端口），可绑定独立域名或二级域名。
  4. 管理端默认账号为admin，默认密码为123456，登录后请立即修改密码，避免账号泄露导致系统被篡改。

四、重要提示与常见问题

核心提醒：每次修改数据库配置、Redis配置后，必须重启后端、前端用户端、前端管理端三个项目，配置才能生效，否则会出现连接失败、数据异常等问题。重启方法：在宝塔Node项目页面，选中对应项目点击「重启」即可。

其他注意事项：

  • 端口放行：确保3000、3001端口在服务器安全组和宝塔防火墙中均已放行，否则外部无法访问前端页面。
  • 依赖问题：若安装依赖时频繁报错，可尝试更换npm镜像源（如淘宝镜像：npm config set registry https://registry.npm.taobao.org）后重新安装。
  • 路径问题：所有项目路径需保持一致，避免因路径错误导致项目启动失败，建议全程使用绝对路径操作。
  • 安全防护：除修改管理端密码外，建议定期更新服务器系统和宝塔面板，关闭不必要的端口，提升系统安全性。