hexo-disqus-proxy

Hexo 插件，解决 disqus 不能访问的反向代理

Demo

准备

• 一台国外的VPS服务器
• 一点点的HTML基本知识

安装

在Hexo博客目录执行

npm install hexo-disqus-proxy --save

前端配置

在你的Hexo博客目录中修改_config.yml文件 添加如下配置：（注意缩进和空格）

disqus_proxy:
  shortname: ciqu
  username: ciqu
  host: disqus-proxy.ycwalker.com
  port: 443
  admin_avatar: /avatars/admin-avatar.jpg
  default_avatar: /avatars/default-avatar.png

其中：

• shortname 是你的website的 shortname 名称 比如在你的disqus安装代码中 有这样一句脚本： s.src = 'https://test-eo9kkdlcze.disqus.com/embed.js'; 那么你的disqus 的shortname 就是 test-eo9kkdlcze
• username 是你的disqus用户名，即评论时候留下的名字，用来区别disqus-proxy的评论头像显示
• host是你启用disqus代理的VPS的域名
• port是VPS服务器启用disqus代理的端口，需要与之后设置的后端一致
• default_avatar和admin_avatar分别是默认头像和管理员头像的路径。例如在source目录下建立avatars目录，放入两个头像，在这里设置成绝对路径。如果不设置，则为默认头像。

关键的一步

在disqus的官方配置中，我们需要在页面合适位置添加一个 <div id="disqus_thread"></div> 作为占位符， 而hexo-disqus-proxy插件并不能知道在页面的哪个位置插入这个标签比较合适，所以这个需要额外配置一下：

情况一

如果你本身用的主题已经支持disqus的配置，那么灰常爽，你只需要正常启用主题的disqus评论，插件就会自动检测并合适的覆盖， 这是最常见的情况，肯定是最吼的。

情况二

在你写的markdown文件底部插入<div id="disqus_thread"></div>。这样评论框位置会位于文章的下方，并且大小能被外部元素所约束，不会乱跑。 什么，markdown也能插入HTML标签？

嗯是的。

情况三

稍微懂一点点hexo的基本知识，自己改主题。大概的思路是，在Hexo渲染的过程中，把<div id="disqus_thread"></div>加在主题目录下的layout目录中 关于博文页面的模板中的合适的位置就行了。

后端配置

获取api-secret

在使用本插件之前需要在 Disqus 申请开启 api 权限。访问register new application 就可以注册一个 application.然后在applications可以看到你的 application 列表。其中 Secret Key 就是我们需要的api-secret,并且需要在后台的Settings => Community里开启访客评论

docker

在安装了docker 的机器上，可以很方便得配置后端。

只需要把 port,your_serect,your_short_name替换成自己的secret 和short_name。

其中port是外部访问的端口。

docker run -d --name disqus-proxy -p 5509:port \
-e DISQUS_API_SECRECT=your_serect \
-e DISQUS_SHORT_NAME=your_short_name \
ycwalker/hexo-disqus-proxy:1.0.6 

如果需要https访问，我们可以用nginx来反向代理disqus proxy.

server {
    listen 443 ssl;
    server_name disqus.domain.com;
    ssl_certificate /etc/ssl/startssl/1_disqus.domain.com_bundle.crt;
    ssl_certificate_key /etc/ssl/startssl/2_disqus.domain.com.key;
    
    location / {
        proxy_set_header  X-Real-IP  $remote_addr;
        proxy_pass http://host:port$request_uri;
    }
}

非docker

后端使用Node.js，需要Node.js版本7.6以上。

在服务器上clone代码:

git clone https://github.com/ciqulover/disqus-proxy

安装依赖

只需要安装后端的依赖

npm i --production
// 或者
yarn install --production

配置server目录下的config.js

module.exports = {
  // 服务端端口，需要与disqus-proxy前端设置一致
    port: 5509,
  
    // 你的diqus secret key
    api_secret: 'your secret key',
  
    // 你的website的 shortname 名称 比如在你的disqus安装代码中 有这样一句脚本：
    // s.src = 'https://test-eo9kkdlcze.disqus.com/embed.js';
    // 那么你的disqus 的shortname 就是 test-eo9kkdlcze
    shortname: 'ciqu',
  
    // 服务端socks5代理转发，便于在本地测试，生产环境通常为null
    // socks5Proxy: {
    //   host: 'localhost',
    //   port: 1086
    // },
  
    socks5Proxy: null,
  
    // 日志输出位置,输出到文件或控制台 'file' | 'console'
    log: 'console'
}

启动

cd server
node index.js

推荐用pm2在生产环境启动，否则你断开ssh，node进程就终止了

npm install pm2 -g
pm2 start index.js

如果你在配置文件中选择log类型为file, 那么输出的日志文件将在默认为server目录下的disqus-proxy.log

Done !