jackhutu / jackblog-api-koa

Jackblog API Server Koa 版, 个人博客系统, 基于RESTful架构, 使用Node.js, Koa, MongoDB, Redis, Token Auth, 七牛云存储等.

jackblog api koa版

此为2.2版,基于koa2.2.x

简介

Jackblog 是使用 Node.js + MongoDB + Redis + 其它客户端框架开发的个人博客系统,前后端分离,仿简书模板.
服务端有: express 版 , koa 版
客户端有: angular1.x 版 , angular2.x 版 , react redux 版 , vue 版
移动端有: react native 版, ionic2.0 版

此为服务端koa版, 为客户端提供api.

环境准备

node.js 7.6+
mognodb 3.0+
redis 2.8+

配置

• 配置文件路径: ./server/config/env, 可将私有配置放入./server/config/env/private 下.
• 七牛云存储配置

  qiniu:{
    app_key:"app_key",
    app_secret:"app_secret",
    domain:"domain",          //七牛配置域名
    bucket:"bucket"           //七牛空间名称  
  },

• 七牛可以不配置, 但如果使用后台管理功能 https://github.com/jackhutu/jackblog-admin, 必须配置七牛.

开发

$ git clone [email protected]:jackhutu/jackblog-api-koa.git
$ cd jackblog-api-koa
$ npm install
$ npm run serve

使用docker容器部署所需的要环境变量

MONGO_PORT_27017_TCP_ADDR
MONGO_USERNAME
MONGO_PASSWORD
REDIS_PORT_6379_TCP_ADDR
REDIS_PORT_6379_TCP_PORT
REDIS_PASSWORD
QINIU_APP_KEY
QINIU_APP_SECRET
QINIU_APP_DOMAIN
QINIU_APP_BUCKET
GITHUB_CLIENT_ID
GITHUB_CLIENT_SECRET
GITHUB_CALLBACK_URL
WEIBO_CLIENT_ID
WEIBO_CLIENT_SECRET
WEIBO_CALLBACK_URL
QQ_CLIENT_ID
QQ_CLIENT_SECRET
QQ_CALLBACK_URL
INITDATA

测试

$ npm test

配合客户端测试的测试模式

$ npm run serve:test

License

MIT

jackblog-api-koa's Issues

windows下运行报错了

$ gulp serve
[00:06:45] Using gulpfile E:\MyProject\bishe\boke\jackblog-api-koa\gulpfile.js
[00:06:45] Starting 'nodemon'...
[00:06:45] Finished 'nodemon' after 2.27 ms
[00:06:45] Starting 'serve'...
[00:06:45] Finished 'serve' after 7.8 μs
[00:06:45] [nodemon] 1.9.1
[00:06:45] [nodemon] to restart at any time, enter rs
[00:06:45] [nodemon] watching: E:\MyProject\bishe\boke\jackblog-api-koa\server/*/
[00:06:45] [nodemon] starting node --harmony server\app.js
module.js:327
throw err;
^

Error: Cannot find module '../build/Release/hcaptha.node'
at Function.Module._resolveFilename (module.js:325:15)
at Function.Module._load (module.js:276:25)
at Module.require (module.js:353:17)
at require (internal/module.js:12:17)
at Object. (E:\MyProject\bishe\boke\jackblog-api-koa\node_modules.npminstall\ccap\0.6.4\ccap\lib\hcap.js:4:13)
at Module._compile (module.js:409:26)
at Object.Module._extensions..js (module.js:416:10)
at Module.load (module.js:343:32)
at Function.Module._load (module.js:300:12)
at Module.require (module.js:353:17)
at require (internal/module.js:12:17)
at Object. (E:\MyProject\bishe\boke\jackblog-api-koa\node_modules.npminstall\ccap\0.6.4\ccap\index.js:1:80)
at Module._compile (module.js:409:26)
at Object.Module._extensions..js (module.js:416:10)
at Module.load (module.js:343:32)
at Function.Module._load (module.js:300:12)
[00:06:46] [nodemon] app crashed - waiting for file changes before starting...

关于七牛云存储的配置问题

我自己申请了一个七牛云的账号，在运行您的上传图片的测试用例时发现上传成功了，但域名是七牛云分配的免费域名，是不是还要配置下镜像存储和绑定一下自己的域名，才能将存储后的路径图片路径通过这样：http://upload.jackhu.top/article/article/test.png 访问。
而且关于这点我还有点不明白的就是这样以来的话我是不是要在自己配置好的那个域名下保存一份，在七牛这边再保存一份呢

errorHandleMiddle模块的一些问题

你好，最近在看你的项目，发现server/util/error/index.js下面对于err.errors的处理好像有点问题：

 if(err.errors && typeof(err.errors) === 'object'){
        _.mapValues(err.errors, (item)=>{
          if(item.message){
            error_msg = item.message     //这里这样的处理可能有错误，error_msg只会保存最后一个message
          }
        })
      }

是错误还是故意为之呢？

还有这个中间件如果是因为代码问题抛出的错误，并且没有对错误进行包装处理，是不是会直接把错误发送暴露给客户端呢？

想问下 Docker镜像下载之后怎么跑起来.

~$ sudo docker run -d -p 8800:7879 --name=blog jackhu/jenkins-deploy-nodejs:6 这样试了不行

一个关于您源码的问题有些看不懂，希望获得您的回答:)

在auth.service.js这个文件里的isAuthenticated方法中，有这样一段，这个user._id是在什么时候传入的，我不是很明白，望作者解答：

比如，我在user.test.js中看到的me方法的调用并没有传入id，但这里调用时会执行isAuthenticated方法时必须要判断传过来的参数中是否有_id,如果这里的me方法没有传的话那又是从哪里传过来的这个_id值呢？

mac npm install 安装不了 报错

WARN tar ENOENT: no such file or directory, open '/Users/rachelhao/Desktop/jackblog-api-koa-master/node_modules/.staging/nyc-102709d8/node_modules/core-js/library/fn/symbol/has-instance.js'
WARN tar ENOENT: no such file or directory, open '/Users/rachelhao/Desktop/jackblog-api-koa-master/node_modules/.staging/nyc-102709d8/node_modules/core-js/library/fn/symbol/to-string-tag.js'
WARN tar ENOENT: no such file or directory, open '/Users/rachelhao/Desktop/jackblog-api-koa-master/node_modules/.staging/nyc-102709d8/node_modules/core-js/library/fn/symbol/for.js'
WARN tar ENOENT: no such file or directory, open '/Users/rachelhao/Desktop/jackblog-api-koa-master/node_modules/.staging/nyc-102709d8/node_modules/core-js/library/fn/symbol/unscopables.js'
WARN tar ENOENT: no such file or directory, open '/Users/rachelhao/Desktop/jackblog-api-koa-master/node_modules/.staging/nyc-102709d8/node_modules/core-js/library/fn/symbol/observable.js'
npm ERR! Unexpected end of JSON input while parsing near '...transpiler":"^5.6.1",'

在windows平台install会报错，错误出在安装koa-redis库的时候

当安装koa-redis时，会要求安装hiredis，此时会抛出以下错误

[email protected] install E:\Study\前端\blog\jackblog\jackblog-api-koa\node_modules\hiredis
node-gyp rebuild
gyp ERR! stack Error: Can't find Python executable "python", you can set the PYTHON env variable.

按要求安装Python后（装的是Python2.7版本），又会抛出C++相关的错误。

请问在windows下，是否有办法成功 install koa-redis ？

同时使用jwt和session的好处是什么呢？

使用token验证，session可以去掉的吧。

程序运行不起来呀

建议添加详细安装说明吧，小白不太懂，
请问win本地测试为什么还要安装Python 2.7，Microsoft Visual Studio C++ 2013呢？
我测试其他nodejs程序都不需要安装这么多呀？

调试问题

项目怎么下断点调试的啊，为什么我使用node-inspector 启动app.js，不能启动。。直接 node app.js就可以。

你网站的github登录一直提示登录失败

你网站的github登录一直提示登录失败

server/util/redis/index.js 这个文件好像没有用到？

发现好像没有被其他地方require?

请问你是基于官方安装的吗？还是用了什么脚手架

npm start error yield next;

gulp serve

[09:26:36] Using gulpfile E:\zan\www\koa\jackblog-api-koa\gulpfile.js
[09:26:36] Starting 'nodemon'...
[09:26:36] Finished 'nodemon' after 2.96 ms
[09:26:36] Starting 'serve'...
[09:26:36] Finished 'serve' after 8.02 μs
[09:26:36] [nodemon] 1.8.1
[09:26:36] [nodemon] to restart at any time, enter rs
[09:26:36] [nodemon] watching: E:\zan\www\koa\jackblog-api-koa\server/*/
[09:26:36] [nodemon] starting node server\app.js
E:\zan\www\koa\jackblog-api-koa\server\config\seed.js:112
yield next;
^^^^^

SyntaxError: Unexpected strict mode reserved word
at exports.runInThisContext (vm.js:53:16)
at Module._compile (module.js:414:25)
at Object.Module._extensions..js (module.js:442:10)
at Module.load (module.js:356:32)
at Function.Module._load (module.js:311:12)
at Module.require (module.js:366:17)
at require (module.js:385:17)
at Object. (E:\zan\www\koa\jackblog-api-koa\server\app.js:23:1
at Module._compile (module.js:435:26)
at Object.Module._extensions..js (module.js:442:10)
at Module.load (module.js:356:32)
at Function.Module._load (module.js:311:12)
at Function.Module.runMain (module.js:467:10)
at startup (node.js:134:18)
at node.js:961:3
[09:26:37] [nodemon] app crashed - waiting for file changes before starting..

网站后台 https://api.jackhu.top 怎么挂了..

网站打不开了!

很喜欢你的程序，但要安装的东西太多了，能简化些吗？

很喜欢你的程序，但要安装的东西太多了，小白好不容易都安装上了，结果cmd里还是大段的错误，能简化些吗？ 使用门槛太高了呀
另外redis 有win32版本的

你这个叫restful风格。。。大哥你开玩笑把。。。

router.get('/getUserList', auth.hasRole('admin'),controller.getUserList)
router.post('/addUser', auth.hasRole('admin'),controller.addUser)
这是restful。。。