1Panel 部署 Node+MongoDB+Nginx 项目实操及避坑指南

在 Linux 服务器上通过 1Panel 面板部署 Node+MongoDB+Nginx 技术栈的项目，可大幅简化环境配置和运维操作。本文整理完整部署步骤，标注实操关键坑点，助力项目快速上线。

一、安装 1Panel 面板

1Panel 的安装可直接通过官网提供的一键命令，在 Linux 服务器终端执行即可：

bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

执行命令后，终端会依次出现交互式询问，需按需配置：

• 是否下载 Docker（建议选择是，后续应用安装依赖 Docker）；
• 设置面板外网访问 URL；
• 自定义面板访问端口号；
• 设置面板登录的用户名和密码。

二、1Panel 面板首次登录

• 安装完成后，终端会输出面板访问路径。若服务器开启了 IPv6，会同时显示 IPv6 和 IPv4 访问地址，直接使用 IPv4 地址 + 面板端口号访问即可；
• 访问前需确认服务器已开放该面板端口号，否则会无法访问；
• 输入配置的用户名和密码，完成首次登录。

![图片]

三、安装项目所需基础软件

• 登录 1Panel 面板后，找到左侧菜单栏的应用商店；
• 因项目基于 Node+MongoDB+Nginx 技术栈，在应用商店中搜索并安装 MongoDB 和 openresty（Nginx 升级版，兼容所有 Nginx 配置）即可。

![图片]

四、部署前文件目录创建（关键避坑步骤）

在部署项目前，需先创建指定的文件目录，目录位置需严格匹配 openresty 安装时默认的网站目录，操作如下：

1. 点击左侧菜单栏系统 > 文件，进入文件管理界面；
2. 定位到 openresty 默认网站目录 /www/sites/（该目录为 openresty 默认，无需修改）；
3. 在 /www/sites/ 下新建项目主文件夹（示例为 app），必须在 app 文件夹内新建 log 文件夹；
   • 避坑：若未创建 log 文件夹，后续部署网站时会直接报错，且系统会自动删除新建的 app 文件夹，需重新创建；
4. 最终项目完整路径为：/www/sites/app。

五、创建静态网站并配置基础信息

1. 点击左侧菜单栏网站 > 创建网站，选择静态网站类型；
2. 按要求填写以下配置项（均为面板内配置，与服务器本身无关）：
   • 域名 / IP：填写服务器公网 IP，若已解析域名可直接填写域名；
   • 端口号：为 1Panel 面板内的端口号，非服务器端口，按需自定义即可；
   • 代号：必须填写项目文件夹名称（示例为 app），需与第四步创建的文件夹名称完全一致；
3. 确认配置时，查看页面下方的对应目录，需将前端静态项目文件全部放入 app/index 目录下，否则会出现文件找不到的报错；
4. 所有配置填写完成后，点击确认，完成静态网站基础创建。

![图片]

六、配置静态文件反向代理（核心步骤）

创建完静态网站后，需配置反向代理，实现前端请求与后端接口的连通，操作如下：

1. 在网站管理列表中，找到刚创建的静态网站，点击右侧配置，进入网站配置页面；
2. 选择反向代理 > 配置文件，进入代理配置编辑界面；
3. 配置代理地址时注意两个核心要点：
   • 配置 api 代理地址：不能填写服务器本机 IP，需填写 1Panel 面板中后端服务的 IP；
   • 配置文件代理地址：同样需填写 1Panel 面板内的 IP，而非服务器 IP；