Homeland - 精美小巧的开源社区论坛系统

源码简介

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

详细教程由 Rat’s Blog 整理，此次就搬运过来，再次加工排版。

演示地址：https://framework.vmoex.com/

功能优点

• 简单，却又丰富，支持Markdown语法来编写正文
• 类似Twitter或微博的方式@一个你需要提及的人
• 支持Twemoji和系统内置表情
• SSO单点登录
• 公共API，基于它开发你的移动应用程序
• 支付宝、微信打赏
• 拖拽上传附件
• 对SEO友善

图片浏览

安装步骤

安装Docker

#CentOS 6
rpm -iUvh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
yum update -y
yum -y install docker-io
service docker start
chkconfig docker on

#CentOS 7、Debian、Ubuntu
curl -sSL https://get.docker.com/ | sh
systemctl start docker
systemctl enable docker

⬛️安装Docker Compose

curl -L https://github.com/docker/compose/releases/download/1.23.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
#验证是否安装成功
docker-compose --version
#返回以下信息即安装成功
docker-compose version 1.23.2, build 1110ad01

⬛️安装依赖

#CenOS系统
yum install make git -y

#Debian/Ubuntu系统
apt install git make -y

⬛️安装Homeland

⬛️创建网站

⬛️下载源码

cd 网站文件夹绝对路径
git clone https://github.com/ruby-china/homeland-docker.git
cd 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 Token
github_secret：GitHub三方登录Application Secret
default_locale：应用程序语言，默认"zh-CN"，可选['zh-CN', 'zh-TW', 'en']
auto_locale：是否自动根据用户浏览器设置，切换到相应的语言，true

更多高级设置，可以查看 官方文档

⬛️编译环境：

make install

如果出现Index does not exist(Elasticsearch::Transport::Transport::Errors::NotFound)提示，为正常情况。

⬛️启动程序：

make start

附加

使用其它端口访问

在编译环境前改下docker-compose.yml文件，大致修改最下面的port端口，比如用8080访问，修改如下：

ports:
  - "8080:80"

配置SSL证书

⬛️编辑app.local.env文件，新增参数：

https=ture
cert_domain=你的域名

⬛️配置SSL：

make install_ssl

⬛️重启：

make restart

相关命令

#更新应用程序，当homeland/homeland这个Docker Image版本变化的时候，需要执行，合并数据库、编译Assets
make update
#启动所有服务，将会自动启动所有的服务
make start
#停止所有服务
make stop
#硬重启服务
make restart
#查看服务状态
make status
进入Rails控制台
make console
#停止所有服务，包括数据库
make stop-all
重建搜索索引
make reindex