我是一个做网站菜鸟,因为兴趣爱好,想搭建一个技术交流社区,准备搭建一个discourse,分享这篇教程,希望对有需要安装discourse的朋友,有帮助,避免踩坑,discourse的中文教程比较少,有的教程已经过时了,全靠翻译软件,研究了好几天。
需要做一个属于自己的discourse需要准备的:
阿里云轻量云服务器香港一个,国内的服务器下载github的插件像蜗牛一样,所以还是推荐用阿里云香港的轻量云,或者其它家轻量服务器,轻量服务器比较便宜,适合新手,配置需要内存大于2GB,不然会无法安装,如果需要装到国内服务器,可以采用香港服务器按量付费,然后用平台里的制作镜像然后克隆到国内服务器的方式,这样会节省踩坑的时间。
一个好记的短域名并解析到服务器ip,推荐com和net,其它域名缺少辨识度,域名可以搜域名批量查询,用规则查询比较短的。
系统:Ubuntu 20.04,比较常用。
开通新的服务器以后,先把防火墙端口都打开(后期调试完毕以后,根据需求关掉端口,只保留用到的端口,省的被黑客攻击),在控制面板设置好root的密码,然后直接在网页上ssh远程连接到服务器上,或者下载 XTerminal之类的ssh软件。
然后粘贴下面三个命令,按回车执行,有选项的时候按yes,升级系统源还有安装git软件。
apt update
apt upgrade -y
apt install git
然后粘贴下面三个命令,按回车执行,用管理员身份,这一步sudo -s如果操作不仔细,会在安装的时候出现一些创建莫名失败的提示,导致安装失败,是因为没有权限导致的。
sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
chmod 700 containers
下载完以后,执行安装向导
./discourse-setup
然后根据提示输入要绑定的域名,第一次安装时间比较久,建议先除了主域名以外其它,随便乱填,然后后面能够成功再重新构建,看不懂的可以用截图加微信图片翻译,邮件可以用阿里云的邮件服务。
然后会有一个提示是继续安装还是按ctrl+c取消,建议继续安装。
安装完成以后访问绑定的域名出现注册页面代表discourse安装成功了。
然后安装一个liunx面板,这一步主要是为了安装其它网站程序,以及方便菜鸟傻瓜式管理用,对比了下这个面板比宝塔要简单很多,而且比较清爽,不会很多广告,而且安装的速度只要几秒钟,不会像宝塔一样,要长时间编译环境。
执行下面的脚本:
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh
安装的时候会提示检测到已经安装过docker,然后出现登陆后台。
按照提示,找到后台登陆进去,在容器管理里面可以看到app,就是discourse,可以在这里启动或者停止。
然后进入文件,编辑app.yml,主要修改的地方,用中文注释了。
## this is the all-in-one, standalone Discourse Docker container template
##
## After making changes to this file, you MUST rebuild
## /var/discourse/launcher rebuild app
##
## BE *VERY* CAREFUL WHEN EDITING!
## YAML FILES ARE SUPER SUPER SENSITIVE TO MISTAKES IN WHITESPACE OR ALIGNMENT!
## visit http://www.yamllint.com/ to validate this file as needed
templates:
- "templates/postgres.template.yml"
- "templates/redis.template.yml"
- "templates/web.template.yml"
## Uncomment the next line to enable the IPv6 listener
#- "templates/web.ipv6.template.yml"
- "templates/web.ratelimited.template.yml"
## Uncomment these two lines if you wish to add Lets Encrypt (https)
- "templates/web.ssl.template.yml"
- "templates/web.letsencrypt.ssl.template.yml"
## which TCP/IP ports should this container expose?
## If you want Discourse to share a port with another webserver like Apache or nginx,
## see https://meta.discourse.org/t/17247 for details
expose:
- "80:80" # http
- "443:443" # https
params:
db_default_text_search_config: "pg_catalog.english"
## Set db_shared_buffers to a max of 25% of the total memory.
## will be set automatically by bootstrap based on detected RAM, or you can override
db_shared_buffers: "128MB"
## 修改附件上传的最大值
upload_size: 300m
## can improve sorting performance, but adds memory usage per-connection
#db_work_mem: "40MB"
## Which Git revision should this container use? (default: tests-passed)
#version: tests-passed
env:
LC_ALL: en_US.UTF-8
LANG: en_US.UTF-8
LANGUAGE: en_US.UTF-8
DISCOURSE_DEFAULT_LOCALE: zh_CN
## How many concurrent web requests are supported? Depends on memory and CPU cores.
## will be set automatically by bootstrap based on detected CPUs, or you can override
UNICORN_WORKERS: 2
## TODO: The domain name this Discourse instance will respond to
## Required. Discourse will not work with a bare IP number.
## 修改主域名
DISCOURSE_HOSTNAME: bbs.izdh.net
## Uncomment if you want the container to be started with the same
## hostname (-h option) as specified above (default "$hostname-$config")
#DOCKER_USE_HOSTNAME: true
## TODO: List of comma delimited emails that will be made admin and developer
## on initial signup example 'user1@example.com,user2@example.com'
## 修改管理员邮箱
DISCOURSE_DEVELOPER_EMAILS: 'xxxx@gmail.com'
## TODO: The SMTP mail server used to validate new accounts and send notifications
# SMTP ADDRESS, username, and password are required
# WARNING the char '#' in SMTP password can cause problems!
## 修改发信邮箱服务器
DISCOURSE_SMTP_ADDRESS: smtpdm.aliyun.com
## 修改发信邮箱端口
DISCOURSE_SMTP_PORT: 80
## 修改为自动发信邮箱账号
DISCOURSE_SMTP_USER_NAME: xxxx@xxx.net
## 修改发信邮箱密码
DISCOURSE_SMTP_PASSWORD: "dj6bCRxoHt25NcD6"
#DISCOURSE_SMTP_ENABLE_START_TLS: true # (optional, default true)
DISCOURSE_SMTP_DOMAIN: smtpdm.aliyun.com
## 修改为自动发信邮箱账号
DISCOURSE_NOTIFICATION_EMAIL: xxxx@xxx.net
DISCOURSE_SMTP_ENABLE_START_TLS: false
## If you added the Lets Encrypt template, uncomment below to get a free SSL certificate
LETSENCRYPT_ACCOUNT_EMAIL: me@example.com
## The http or https CDN address for this Discourse instance (configured to pull)
## see https://meta.discourse.org/t/14857 for details
#DISCOURSE_CDN_URL: https://discourse-cdn.example.com
## The maxmind geolocation IP address key for IP address lookup
## see https://meta.discourse.org/t/-/137387/23 for details
#DISCOURSE_MAXMIND_LICENSE_KEY: 1234567890123456
## The Docker container is stateless; all data is stored in /shared
volumes:
- volume:
host: /var/discourse/shared/standalone
guest: /shared
- volume:
host: /var/discourse/shared/standalone/log/var-log
guest: /var/log
## Plugins go here
## see https://meta.discourse.org/t/19157 for details
## 安装2个插件
hooks:
after_code:
- exec:
cd: $home/plugins
cmd:
- git clone https://github.com/discourse/docker_manager.git
- git clone https://github.com/discourse/discourse-solved
- git clone https://github.com/discourse/discourse-reactions
## Any custom commands to run after building
run:
- exec: echo "Beginning of custom commands"
## If you want to set the 'From' email address for your first registration, uncomment and change:
## After getting the first signup email, re-comment the line. It only needs to run once.
#- exec: rails r "SiteSetting.notification_email='info@unconfigured.discourse.org'"
- exec: echo "End of custom commands"
修改保存以后,回到终端,使用指令或者在后台停止容器,然后再重构,不过好像没安装这个面板可以不用停止容器,安装这个面板了以后不停止容器直接重构会报错。
./launcher stop app
./launcher bootstrap app`
等待重构完成,执行容器启动命令。
./launcher start app
进入discourse,会提示发邮件激活,如果收不到,可以用下面指令,创建一个管理员账号直接跳过,然后在左边设置里语言设置为中文即可,然后有个地方可以发邮件测试,会提示报错原因,多试几次就可以成功了。
./launcher enter app
rake admin:create
如果需要创建其它网站,直接参考官方的教程,比较简单就不详细介绍了,也可以在网站里,新建一个环境,然后网站权限修改成777,就可以安装各种程序了。
主要解决的问题,可以一个服务器运行几个网站,这样节省了买服务器的费用,而且更加适合新手。
后面测试邮件发送的时候发现的一个问题:
容器的这些设置,编辑app.yml里面,重构好像并不起作用,需要在容器环境变量这里修改,不过只需要5-6秒就可以生效,对插件安装有没有影响还不太清楚。
和其它网站共存好像就是先新建一个反向代理,然后把默认的容器443端口改成一个10443,然后要配置证书,就能正常访问了。
反向代理
配置证书