DoraCMS NodeJS CMS搭建
DoraCMS 是一款基于 Node.js 的内容管理系统，适合用来开发企业官网、博客等现代站点。
如果你刚接触 Node.js 建站，希望在一台干净的 Linux 服务器上把它跑起来，这篇教程会从零开始，带你完成环境准备、代码部署、数据库连接和访问验证，并给出常见报错的排查思路。
搭建前需要准备什么
开始之前，请确认你有一台可以登录的 Linux 服务器（推荐 Ubuntu 20.04 或 CentOS 7 以上），并已安装宝塔面板或具备命令行操作能力。
同时准备好以下环境：
- Node.js：建议使用 LTS 版本，如 16.x 或 18.x，可通过
node -v检查。 - MongoDB：DoraCMS 默认使用 MongoDB 作为数据库，版本 4.x 以上均可。
- Nginx：用于反向代理和域名绑定。
- Git：用于拉取源码。
如果你使用的是宝塔面板，可以在“软件商店”中直接安装 Node.js 版本管理器和 MongoDB，省去手动编译的步骤。
安装 Node.js 与 MongoDB
在宝塔面板中安装 Node.js 时，选择“Node.js 版本管理器”，安装 v16 或 v18，并设置为默认版本。
安装完成后，在终端执行 node -v 和 npm -v 应能正确输出版本号。
MongoDB 同样在宝塔软件商店中搜索安装，安装后记得在“安全”页面放行 27017 端口（或仅限本地访问）。
如果手动安装，可使用以下命令（以 Ubuntu 为例）：
sudo apt update
sudo apt install -y mongodb
sudo systemctl start mongodb
sudo systemctl enable mongodb安装完成后，用 mongo --version 验证。
拉取 DoraCMS 源码并安装依赖
进入网站根目录，例如 /www/wwwroot，使用 Git 克隆官方仓库：
cd /www/wwwroot
git clone https://github.com/doramart/DoraCMS.git
cd DoraCMS接着安装项目依赖。
如果 npm 速度慢，可先切换淘宝源：
npm config set registry https://registry.npmmirror.com
npm install注意：
安装过程中若出现 node-gyp 相关报错，
通常是缺少编译工具，
可执行 apt install -y build-essential 或 yum groupinstall "Development Tools" 解决。
配置数据库与启动项目
DoraCMS 的配置文件通常位于 config 目录下，找到 default.js 或 production.js，修改 MongoDB 连接地址：
module.exports = {
mongoose: {
url: 'mongodb://127.0.0.1:27017/doracms',
options: {}
}
};如果 MongoDB 设置了用户名密码，需要按 mongodb://user:pass@127.0.0.1:27017/doracms 格式填写。
启动项目前，建议先初始化数据库。
部分版本提供初始化脚本，可执行：
npm run init若没有该命令，可直接启动，系统会自动创建集合。
启动命令为：
npm start或使用 PM2 守护进程：
npm install pm2 -g
pm2 start app.js --name doracms
pm2 save启动后，默认监听 3000 端口，浏览器访问 http://服务器IP:3000 应能看到首页。
配置 Nginx 反向代理与域名
为了让用户通过域名访问，需要在宝塔面板中新建站点，绑定域名，然后设置反向代理。
在站点设置中找到“反向代理”，添加目标 URL 为 http://127.0.0.1:3000，并保存。
如果手动配置 Nginx，可在站点配置文件中加入：
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}保存后重载 Nginx：nginx -s reload。
此时用域名访问，应能正常打开网站。
常见报错与避坑指南
启动时报错“Cannot find module”：通常是依赖未安装完整，进入项目目录重新执行 npm install。
访问显示 502 Bad Gateway：检查 Node 进程是否在运行，可用 pm2 list 查看；
若未运行，查看日志 pm2 logs doracms 定位错误。
MongoDB 连接失败：确认 MongoDB 服务已启动，且防火墙未拦截 27017 端口。
如果 MongoDB 绑定的是 127.0.0.1，远程连接会失败，需修改 /etc/mongod.conf 中的 bindIp。
后台登录默认账号密码：安装初始化后，默认管理员账号通常为 admin，密码 123456，首次登录后请立即修改。
文件上传失败：检查项目目录的 public/upload 文件夹是否有写入权限，可执行 chmod -R 755 public/upload。
验证搭建是否成功
完成上述步骤后，依次检查：
- 浏览器访问域名，首页正常加载，无样式错乱。
- 访问
/admin后台路径，能出现登录页面。 - 使用默认账号登录，能进入管理界面并发布一篇测试文章。
- 在服务器执行
pm2 list，DoraCMS 进程状态为 online。
如果这些检查都通过，说明 DoraCMS 已经成功运行，你可以开始进行企业站点的模板开发和内容填充了。
几个常见疑问
DoraCMS 支持哪些数据库？ 默认使用 MongoDB，暂不官方支持 MySQL，如需更换需自行改造数据层。
必须用宝塔面板吗？ 不是必须，但宝塔能简化 Node.js 和 MongoDB 的安装，对新手更友好。
如何更新 DoraCMS？ 进入项目目录，执行 git pull 拉取最新代码，然后重启 PM2 进程即可，更新前建议备份数据库。
为什么访问后台提示 404？ 检查 Nginx 反向代理是否配置正确，并确认 Node 服务已启动。
部分版本后台路径可能为 /admin/login，请以实际路由为准。
按照以上步骤操作，你应该能顺利完成 DoraCMS NodeJS CMS 的搭建，并用于现代企业站点开发。
如果遇到其他异常，优先查看 PM2 日志和 MongoDB 日志，多数问题都能从中找到线索。
