在 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 安装时默认的网站目录，操作如下：
- 点击左侧菜单栏系统 > 文件，进入文件管理界面；
- 定位到 openresty 默认网站目录
/www/sites/（该目录为 openresty 默认，无需修改）； - 在
/www/sites/下新建项目主文件夹（示例为app），必须在app文件夹内新建log文件夹；- 避坑：若未创建
log文件夹，后续部署网站时会直接报错，且系统会自动删除新建的app文件夹，需重新创建；
- 避坑：若未创建
- 最终项目完整路径为：
/www/sites/app。
五、创建静态网站并配置基础信息
- 点击左侧菜单栏网站 > 创建网站，选择静态网站类型；
- 按要求填写以下配置项（均为面板内配置，与服务器本身无关）：
- 域名 / IP：填写服务器公网 IP，若已解析域名可直接填写域名；
- 端口号：为 1Panel 面板内的端口号，非服务器端口，按需自定义即可；
- 代号：必须填写项目文件夹名称（示例为
app），需与第四步创建的文件夹名称完全一致；
- 确认配置时，查看页面下方的对应目录，需将前端静态项目文件全部放入
app/index目录下，否则会出现文件找不到的报错； - 所有配置填写完成后，点击确认，完成静态网站基础创建。
![图片]
六、配置静态文件反向代理（核心步骤）
创建完静态网站后，需配置反向代理，实现前端请求与后端接口的连通，操作如下：
- 在网站管理列表中，找到刚创建的静态网站，点击右侧配置，进入网站配置页面；
- 选择反向代理 > 配置文件，进入代理配置编辑界面；
- 配置代理地址时注意两个核心要点：
- 配置 api 代理地址：不能填写服务器本机 IP，需填写 1Panel 面板中后端服务的 IP；