ruby语言构建的论坛程序Homeland部署安装详细教程

HUI 技术 01-21 216 0

Homeland，一款基于Rails的开源、免费、不限制商业使用的社区/论坛系统，很轻巧，整体布局页不错，功能也很强大的，支持将文件存储在本地、UpYun、Aliyun OSS，用户可以在自己的文章中上传微信/支付宝收款码，官方也给出了Docker安装方法，搭建起来自然就变的很简单了
官方首页截图

ruby语言构建的论坛程序Homeland部署安装详细教程 — Homeland首页界面

功能简单，却又丰富你可以使用简单的文本来进行发帖或回帖，但在复杂的时候，你可以可以选择优雅的Markdown语法来编写正文。同时Homeland已经默认提供了一套排版整洁的阅读页面风格。
@提及功能你可以在发帖或回帖的时候，用类似Twitter或微博的方式@一个你需要提及的人，系统将会发送通知提醒对方。
丰富的表情系统在讨论的时候如果附带一些表情，你的意思将能表达的更清楚，Homeland支持Twemoji和系统内置表情。
SSO单点登录你可以将Homeland和任何现有系统结合实现单点登录功能，你还可以将Homeland作为SSO的提供址，给其他系统同步账号与登录。
公共APIHomeland已经内置了一套AP`系统，在你需要的时候你可以基于它开发你的移动应用程序。
支付宝、微信打赏支持用户上传个人收款二维码，打赏按钮将会在话题页面显示。
拖拽上传附件你可以直接将一个图片拖动到发帖／回帖输入框中来实现快速的上传。此外还可以复制、粘贴来上传哦！
对SEO友善Homeland的各方面设计是对SEO友善的，请Google搜索Ruby China查看案例的实际收录效果。
安装Github地址：http://github.com/ruby-china/homeland
官方论坛：https://www.ruby-china.org/
提示：官方推荐服务器内存为4G，不过博主用512M内存倒是可以，前提加点虚拟内存，内存不够的可以用下Swap一键脚本。

#CentOS 6rpm -iUvh http://dl.fedoraproject.org/pub/ ... e-6-8.noarch.rpmyum update -yyum -y install docker-ioservice docker startchkconfig docker on
#CentOS 7、Debian、Ubuntucurl -sSL https://get.docker.com/ | shsystemctl start dockersystemctl enable docker2、安装Docker Compose

1 2	#CentOS 6rpm -iUvh http://dl.fedoraproject.org/pub/ ... e-6-8.noarch.rpmyum update -yyum -y install docker-ioservice docker startchkconfig docker on #CentOS 7、Debian、Ubuntucurl -sSL https://get.docker.com/ \| shsystemctl start dockersystemctl enable docker2、安装Docker Compose

使用以下命令：

curl -L https://github.com/docker/compos ... 3.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-composechmod +x /usr/local/bin/docker-compose

1	curl -L https://github.com/docker/compos ... 3.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-composechmod +x /usr/local/bin/docker-compose

验证是否安装成功docker-compose --version
返回以下信息即安装成功docker-compose version 1.23.2, build 1110ad013、

安装依赖

#CenOS系统yum install make git -y
#Debian/Ubuntu系统apt install git make -y4、安装Homeland
#下载源码git clone https://github.com/ruby-china/homeland-docker.gitcd homeland-docker
#新建配置文件cp app.local.env.example app.local.env
#编辑配置文件nano app.local.env配置文件参数如下：
#必要参数app_name：网站名称domain：网站的域名admin_emails：管理员Email，多个管理员Email，用英文逗号分隔
#可选参数，这些参数也可以自己搭建好了后，在后台进行配置modules：可拔插组件配置，
详见: https://gethomeland.com/docs/configuration/modules/

#CenOS系统yum install make git -y

#Debian/Ubuntu系统apt install git make -y4、安装Homeland

#下载源码git clone https://github.com/ruby-china/homeland-docker.gitcd homeland-docker

#新建配置文件cp app.local.env.example app.local.env

#编辑配置文件nano app.local.env配置文件参数如下：

#必要参数app_name：网站名称domain：网站的域名admin_emails：管理员Email，多个管理员Email，用英文逗号分隔

#可选参数，这些参数也可以自己搭建好了后，在后台进行配置modules：可拔插组件配置，

详见: https://gethomeland.com/docs/configuration/modules/

https：开启Homeland的SSL功能asset_host：自定义网站静态资源文件的Host，保持为空将不启用 google_analytics_key：Google Analytics统计的key mailer_provider：邮件发送方式: [smtp, postmark]mailer_sender：邮件通知发件人mailer_options：邮件服务详细配置，根据mailer_provider参数有可能不同，
详见：https://gethomeland.com/docs/configuration/mailer/github_token：GitHub三方登录Application Tokengithub_secret：GitHub三方登录Application Secretdefault_locale：应用程序语言，默认"zh-CN"，可选['zh-CN', 'zh-TW', 'en']auto_locale：是否自动根据用户浏览器设置，切换到相应的语言，true配置选项官方说的很详细了，还有很多高级设置，比如文件上传配置等可以查看官方文档。
以下在原有配置参数下设置的基本参数，如下：app_name=MOERATSdomain=bbs.moerats.comadmin_emails=moerats@live.com
编译环境：make install如果出现Index does not exist(Elasticsearch::Transport::Transport::Errors::NotFound)提示，为正常情况。
启动程序：make start然后就可以使用域名访问了，但前提是服务器80和443端口不被占用，如果你想用其它端口访问，就需要在编译环境前改下docker-compose.yml文件，大致修改最下面的port端口，比如用8080访问，修改如下：ports: - "8080:80"

配置SSL证书

编辑app.local.env文件，
新增参数：https=turecert_domain=bbs.moerats.com
然后开始配置SSL：make install_ssl
重启：make restart然后就可以直接打开了。

不过这里安装ssl的时候，出现点问题，https站点也会打不开，不知道是使用姿势问题还是最新的Dokcer配置有点小问题，然后使用之前的老版本安装倒是没这个ssl问题，出于强迫症，博主肯定想用下最新的，所以这里就想了个解决办法，就说一下。
这里是接着上面出错后才开始继续，如果以后申请/配置ssl没问题了是最好的，那么该步可以省掉了。

#关闭程序的容器make stop-all
#清空镜像docker rm $(docker ps -aq)docker rmi $(docker images -q)docker volume rm $(docker volume ls -q)
#进入源码文件夹cd homeland-docker
#然后编辑docker-compose.ymlnano docker-compose.yml大致修改如下：
#在指定的地方volumes下面新增2行代码app: &app_base  container_name: 'homeland_app'  .  volumes:    - ./etc/homeland.conf:/etc/nginx/homeland.conf    - ./etc/nginx.conf:/etc/nginx/nginx.conf
#在最下面修改下nginx启动参数web:  <<: *app_base  .  command: nginx -c /etc/nginx/nginx.conf然后使用Ctrl+x、y保存退出。接下来下载2个配置文件到etc文件夹，使用命令:
#进入源码文件夹的ect目录cd etcwget https://www.moerats.com/usr/down/homeland-docker-conf.zip
#解压并删除unzip homeland-docker-conf.zip && rm -rf homeland-docker-conf.zip
#开始安装容器环境cd ..make install
#最后启动make start不出意外的话，这里SSL就配置好了，也可以访问了。然后进入后，使用你设置好的管理员邮箱进行注册，那该邮箱立即变成管理员。

#关闭程序的容器make stop-all

#清空镜像docker rm $(docker ps -aq)docker rmi $(docker images -q)docker volume rm $(docker volume ls -q)

#进入源码文件夹cd homeland-docker

#然后编辑docker-compose.ymlnano docker-compose.yml大致修改如下：

#在指定的地方volumes下面新增2行代码app: &app_base container_name: 'homeland_app' . volumes: - ./etc/homeland.conf:/etc/nginx/homeland.conf - ./etc/nginx.conf:/etc/nginx/nginx.conf

#在最下面修改下nginx启动参数web: <<: *app_base . command: nginx -c /etc/nginx/nginx.conf然后使用Ctrl+x、y保存退出。接下来下载2个配置文件到etc文件夹，使用命令:

#进入源码文件夹的ect目录cd etcwget https://www.moerats.com/usr/down/homeland-docker-conf.zip

#解压并删除unzip homeland-docker-conf.zip && rm -rf homeland-docker-conf.zip

#开始安装容器环境cd ..make install

#最后启动make start不出意外的话，这里SSL就配置好了，也可以访问了。然后进入后，使用你设置好的管理员邮箱进行注册，那该邮箱立即变成管理员。

相关命令
#更新应用程序，当homeland/homeland这个Docker Image版本变化的时候，需要执行，合并数据库、编译Assetsmake update
#启动所有服务，将会自动启动所有的服务 make start
#停止所有服务 make stop
#硬重启服务 make restart
#查看服务状态 make status进入Rails控制台 make console
#停止所有服务，包括数据库make stop-all 重建搜索索引make reindex
最后有其他的配置问题可以自行看下官方文档，然后慢慢琢磨。

总结：不得不说此程序设计借鉴了v2ex的设计界面，在操作界面上精炼更迭了数年，在GitHub上每周都有小伙伴进行代码更新，是少数的还在更新的开源软件。