本指南介绍的是在开发环境中安装 Discourse 的步骤。如需了解生产环境安装指南,请访问:Install Discourse in production with the official supported instructions
您想在 Ubuntu 或 Debian 上搭建 Discourse 以便进行开发和调试吗?
我们将假设您是在本地工作,并且您的 Ubuntu 或 Debian 系统上尚未安装 Ruby/Rails/Postgres/Redis。让我们开始吧!
系统要求
我们建议至少配备 4 GB 内存和 2 个 CPU 核心。
当前兼容性:
| 操作系统 | 兼容性 |
|---|---|
| Debian 11 | |
| Crostini (ChromeOS 上的 Linux) | |
| Ubuntu 22.04 或更高版本 |
安装 Discourse 依赖项
您的系统中需要安装以下软件包:
- Git
- rbenv 或 asdf
- ruby-build
- Ruby(最新稳定版)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- libvips
- MailHog**
- ImageMagick**
** 可选
现在我们已经安装了 Discourse 的依赖项,接下来让我们安装 Discourse 本身。
克隆 Discourse 仓库
将 Discourse 仓库克隆到 ~/discourse 文件夹中:
git clone https://github.com/discourse/discourse.git ~/discourse
~ 表示主目录,因此 Discourse 源代码将位于您的主目录中。
配置数据库
创建一个与您的 Linux 系统用户名相同的角色:
cd /tmp && sudo -u postgres createuser -s "$USER"
[/details]
初始化 Discourse
切换到您的 Discourse 文件夹:
cd ~/discourse
安装所需的 gems
source ~/.bashrc
bundle install
安装 JS 依赖项
pnpm install
现在您已经成功安装了 gems,请运行以下命令:
bin/rails db:create
bin/rails db:migrate
RAILS_ENV=test bin/rails db:create db:migrate
启动 rails 和前端打包器:
bin/dev
如果图片未显示,请改用以下命令:
(如果您是在远程服务器上工作,也可以指定 IP 地址)
DISCOURSE_HOSTNAME=localhost UNICORN_LISTENER=localhost:3000 bin/dev
现在,您应该能够访问 http://localhost:3000 来查看您的本地 Discourse 安装。
创建新管理员
要创建新的管理员,请运行以下命令:
bin/rails admin:create
按照提示操作,即可创建一个新的管理员账户。
配置邮件
运行 MailHog:
mailhog
恭喜!您现在是自己 Discourse 安装的管理员了!
祝您开发愉快!若要开始入门,请参阅创建 Discourse 插件的新手指南。
最后由 @blake 于 2023-04-03T06:00:00Z 审核
本文档受版本控制 - 建议修改 在 github 上。