DoraCMS是基于Nodejs+eggjs+mongodb编写的一套内容管理系统，结构简单，较目前一些开源的cms，doracms易于拓展，特别适合前端开发工程师做二次开发。
www.html-js.cn
快速开始体验
如何安装
在安装
安装
下载并安装
安装
启动
新建配置文件
启动
www.html-js.cn
2.1.6 版本更新
api文档换成swagger-ui- 修复
gulp不兼容node 12+的问题 - 修改了后台密码的加密方式
- 文档添加加入了自动生成缩略图功能
- 文档管理加入了回收站功能
- 加入插件功能
- 加入数据恢复功能
- 补充国际化文件
- 修复了一些其它bug
说明
DoraCMS 2.1.6 使用的技术栈：
1、nodejs 12 + eggjs 2
2、vue-cli
3、mongodb 4+
后台登录： https://www.html-js.cn/dr-admin
测试账号：doracms/123456
测试账号：doracms/123456
快速开始体验 DoraCMS（推荐）
前提是您需要提前安装docker. 这里介绍的是本地体验，如果你想运行在服务器上，需要先修改配置文件 config/config.local.js 里的server_pathserver_api为您服务器的IP+端口号。该操作仅为快速体验，如果正式环境部署，请移步后面的如何安装 DoraCMS（开发环境/生产环境）
DoraCMS 可以依托 docker-compose 快速在本地跑起来，您只需要这样做：- 下载代码到本地，进入代码根目录，终端执行
docker-compose up -d
接下来等待几分钟，看到执行成功后，浏览器访问
http://127.0.0.1:8080/
如何安装 DoraCMS（开发环境/生产环境）
在安装 DoraCMS 之前，需要确保您已经完成了以下工作
- 已经安装好了
nodejs, 版本v12.13.0 - 已经安装并启动了
Mongodb，版本4.0
安装 DoraCMS 只需要一步
在完成上述准备工作后，代码根目录下执行(如果下次重新执行，需要重新checkout代码回到仓库原始状态)
npm run doracms
下面就按照上面的步骤详细讲解：
下载并安装 nodejs
nodejs 可以去官网下载，你可以去 安装包列表 中找到需要的安装包，具体的安装方式可自行百度。https://nodejs.org/dist/latest-v10.x/node-v12.13.0.pkg // Mac Pro
https://nodejs.org/dist/latest-v10.x/node-v12.13.0-x64.msi // windows 64位
https://nodejs.org/dist/latest-v10.x/node-v12.13.0-x86.msi // windows 32位
安装完成后，打开终端，确认是否安装成功
node -v // v12.13.0
安装 mongodb
https://fastdl.mongodb.org/osx/mongodb-osx-ssl-x86_64-4.0.16.tgz // Mac 安装包地址
解压后的目录结构
启动 mongodb
不同平台启动 mongodb 方式基本相同
新建配置文件 mongodb.config
dbpath=/Users/dora/Documents/dora/softs/mongodb/data/ #数据存放路径
logpath=/Users/dora/Documents/dora/softs/mongodb/log/mongodb.log #日志存放路径
fork=true #进程守护
#auth=true #是否鉴权
auth 代表鉴权，这里演示的是本地启动，可以不要密码，因此注释掉了，在生产环境上 auth 必须为 true,且 mongodb 要配置密码。详情查询 DoraCMS生产环境部署 里的第七步，详细介绍了如何给 mongodb 加密码
启动 mongodb
终端执行
mongod --config C:\mongodb\mongod.conf
可以看到结尾处提示
mongodb 启动成功了启动项目
修改配置文件
install -> serverConfig.js，根据实际情况修改，配置文件中的备注很明确，请仔细阅读
cd install
vim serverConfig.js
参数配置详情
一定要注意mongodbBinPath,在windows环境下路径中\必须改为/如C:/mongodb/mongodb/bin/才是正确的，另外，bin路径中不要包含中文或空格
/**
* 服务器配置信息
* @param {String} env [[必填]服务器环境 development:开发环境，production:生产环境]
* @param {String} mongodbBinPath [[必填]Mongodb bin目录路径，注意结尾必须带 / ，windows 环境下路径中 \ 必须改为 / 如 C:/mongodb/mongodb/bin/ ]
* @param {String} dbIP [[必填]Mongodb 数据库IP，默认 127.0.0.1 默认不用更改]
* @param {String} dbPort [[必填]Mongodb 数据库端口号，默认为 27017 默认不用更改]
* @param {String} dbName [Mongodb 数据库名称，默认为 doracms2 默认不用更改]
* @param {String} dbUserName [Mongodb 数据库用户名，没有可以不填，和 dbPassword 同时存在或同时为空]
* @param {String} dbPassword [Mongodb 数据库密码，没有可以不填，和 dbUserName 同时存在或同时为空]
* @param {String} os [[必填]服务器平台 Mac,Windows,Linux 可选]
* @param {String} domain [[必填]网站访问域名或IP+端口号，需要带http/https,如 https://www.html-js.cn, http://120.25.150.169:8080]
* @param {String} port [[必填]DoraCMS 启动默认端口号，domain 中如果也有端口号，那么理论上这两个端口号是相同的]
* @param {String} tbAgent [[必填]NPM安装包是否启用淘宝代理 1：启用 0：不启用，建议启用]
*/
const serverConfig = {
env: "development",
mongodbBinPath: "C:/mongodb/mongodb/bin/",
dbIP: "127.0.0.1",
dbPort: "27017",
dbName: "doracms2",
dbUserName: "",
dbPassword: "",
os: "Windows",
domain: "http://127.0.0.1:8080",
port: 8080,
tbAgent: "1",
}
module.exports = serverConfig;
代码根目录执行
此处通过执行脚本省去了安装依赖，配置文件修改等操作，大概需要几分钟的时间，请耐心等待，如果有提示错误，请根据提示做相应的调整
npm run doracms
浏览器通过以下方式访问（具体访问地址依赖于第一步的配置）
http://127.0.0.1:8080 // 开发环境
http://120.25.150.169:8080 // 生产环境只配了IP，端口号已加入安全组
https://www.html-js.cn // 生产环境配置了域名并做好了域名解析
如果你不想看那么多文字，这里为你准备了视频，更加直观
网站图片资源可从这里获取 下载链接: https://pan.baidu.com/s/1th7Qlz4eJGNN3w_Tacl9AQ 提取码: jczt ，解压后放到项目根目录下 app/public/upload (替换)。
其它
开发环境启动
npm run dev
生产环境启动
pm2 start server.js --name doracms2
生产环境停止
pm2 stop doracms2
生产环境重启
pm2 restart doracms2
api文档
api访问地址： http://127.0.0.1:8080/static/apidoc/index.html
首页
http://127.0.0.1:8080
后台登录
http://127.0.0.1:8080/dr-admin
登录账号：doramart/123456 doracms/123456
清空数据
启动mongodb（执行mongodb安装目录下mongod.exe），cmd窗口打开mongo.exe
// 查看数据库列表
show dbs
// 查看集合列表
show collections
// 使用数据库doracms2
use doracms2
// 清除所有文章信息
db.contents.find()
db.contents.remove({})
// 清除所有留言信息
db.messages.find()
db.messages.remove({})
frm https://github.com/doramart/DoraCMS
No comments:
Post a Comment