本文记录了在 Debian 8 上安装 Discourse 的完整过程，包含设置 Swap、安装 Docker、配置 Discourse、邮箱 SMTP、初始化论坛与创建管理员等步骤。部分命令同样适用于 Debian 9 / Ubuntu 系列系统。
一、准备工作：增加 Swap（1GB 内存必做）
由于 Discourse 最低要求 1GB RAM + 1GB Swap，如果你的主机内存较小，请先创建 Swap：
sudo install -o root -g root -m 0600 /dev/null /swapfile
dd if=/dev/zero of=/swapfile bs=1k count=1024
mkswap /swapfile
swapon /swapfile
设置开机自启：
echo "/swapfile swap swap auto 0 0" | sudo tee -a /etc/fstab
优化 Swap 使用率：
sysctl -w vm.swappiness=10
echo "vm.swappiness = 10" | sudo tee -a /etc/sysctl.conf
二、安装 Docker 与 Git
1. 安装 Docker（Debian 8）
wget -qO- https://get.docker.io/ | sh
2. 安装 Git
apt update
apt install git -y
验证：
git --version
三、下载并准备 Discourse Docker 环境
mkdir /var/discourse
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
cp samples/standalone.yml containers/app.yml
四、编辑 Discourse 配置文件（app.yml）
nano containers/app.yml
建议修改以下配置：
db_shared_buffers: "128MB" # 适用于 1GB 内存机器
version: stable # 使用稳定版
DISCOURSE_DEFAULT_LOCALE: zh_CN # 设置中文
DISCOURSE_HOSTNAME: 'www.abc.com' # 你的论坛域名
DISCOURSE_DEVELOPER_EMAILS: 'abc@qq.com' # 管理员邮箱
DISCOURSE_SMTP_ADDRESS: smtp.gmail.com # SMTP 服务器
DISCOURSE_SMTP_PORT: 587 # 端口
DISCOURSE_SMTP_USER_NAME: abc@gmail.com # SMTP 用户
DISCOURSE_SMTP_PASSWORD: <你的邮箱密码>
⚠ SMTP 必须填对，否则无法注册管理员账号！
五、初始化 Discourse
cd /var/discourse
sudo ./launcher bootstrap app
构建过程约需 5～10 分钟。
启动 Discourse：
sudo ./launcher start app
访问：
http://你的域名
六、Debian/Ubuntu Docker 常见安装补充（可选）
如遇到 Ubuntu 没有 docker 命令 的情况：
sudo apt-get update && sudo apt-get dist-upgrade -y
sudo reboot
wget -qO- https://get.docker.com/ | sh
检查 Docker 状态：
systemctl status docker
systemctl is-enabled docker
确保 Docker 开机自启。
七、创建 Discourse 管理员账户（如无法自动创建）
进入容器：
./launcher enter app
创建管理员：
rake admin:create
按提示输入邮箱和密码即可。
八、Swap 操作补充（扩容 / 删除）
扩容示例：创建 2GB Swap
dd if=/dev/zero of=/swapfile bs=1024 count=2000000
mkswap /swapfile
chown root:root /swapfile
chmod 0600 /swapfile
swapon /swapfile
写入开机自启：
echo "/swapfile swap swap defaults 0 0" | tee -a /etc/fstab
删除 Swap
swapoff /swapfile
rm /swapfile
🏁 本文详细介绍了：
- Debian 8 安装 Discourse 必要的 Swap 设置
- Docker + Git 的安装方式
- Discourse Docker 环境搭建
- app.yml 详细配置与 SMTP 设置
- 初始化与启动 Discourse
- 创建管理员用户
- 维护性命令补充
无论你是部署个人论坛、技术社区，还是内部沟通平台，这篇记录都能帮助你快速成功搭建并运行 Discourse。
