在 Windows 上安装 Discourse 进行开发

[Discourse]

本教程已在 Windows 10 和 11 上测试通过。

要在 Windows 上为 Discourse 搭建开发环境，您可以使用 适用于 Linux 的 Windows 子系统 功能。

此设置需要安装 WSL 2。它仅在 Windows 10 版本 18917 或更高版本中可用。 我们假设您已经在 Windows 10 系统上安装了 适用于 Linux 的 Windows 子系统 2 (Ubuntu)。警告： 请安装 Ubuntu 18.04，而不是 20.04，因为在 20.04 上某些安装会失败。更多信息请参阅本文底部的 2020 年 6 月 30 日备注。

让我们开始吧！

安装 Discourse

1. 最初请按照主题 在 Ubuntu 上安装 Discourse 进行开发的初学者指南 中的步骤操作，直到 克隆 Discourse 这一步。

@techAPJ

安装 Discourse 依赖项

您的系统需要以下软件包：

• Git
• rbenv 或 asdf
• ruby-build
• Ruby（最新稳定版）
• Rails
• PostgreSQL
• SQLite
• Redis
• Node.js
• pnpm
• MailHog**
• ImageMagick**

** 可选

既然我们已经安装了 Discourse 的依赖项，接下来就安装 Discourse 本身吧。

2. 在设置数据库之前，您必须使用以下命令手动启动 PostgreSQL 服务和 Redis 服务器：

   sudo service postgresql start
   redis-server --daemonize yes
   

3. 然后完成 Ubuntu 指南 中的所有剩余步骤。

@techAPJ

克隆 Discourse

将 Discourse 仓库克隆到 ~/discourse 文件夹：

git clone https://github.com/discourse/discourse.git ~/discourse

~ 表示主文件夹，因此 Discourse 源代码将位于您的主文件夹中。

设置数据库

创建一个与您的 Ubuntu 系统用户名相同的角色：

sudo -u postgres createuser -s "$USER"

引导 Discourse

切换到您的 Discourse 文件夹：

cd ~/discourse

安装所需的 gems

source ~/.bashrc
bundle install

既然您已经成功安装了 gems，请运行以下命令：

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

尝试运行测试：

bundle exec rake autospec

所有测试都应该通过。

启动 Rails 服务器：

bundle exec rails server

现在您应该能够通过 http://localhost:3000 连接到您的 Discourse 应用——试试看吧！

在另一个终端实例中，导航到您的 discourse 文件夹（cd ~/discourse）并运行：

bin/dev --only ember

这将启动前端打包程序；应用仍将从 http://localhost:3000 提供服务。

创建启动 Discourse 的命令

现在您的开发环境几乎已经准备就绪。 唯一的问题是，每次在 Windows 上打开 Ubuntu 时，您都必须手动启动 PostgreSQL 服务和 Redis 服务器。别担心，我们可以通过创建一个自定义命令来解决这个问题：

cd ~

使用命令 nano start-discourse 创建一个新文件，粘贴以下内容，然后保存并退出。

#!/bin/bash

# 启动 PostgreSQL
sudo service postgresql start

# 启动 Redis 服务器
redis-server --daemonize yes

现在使用以下命令修改 CHMOD

chmod +x start-discourse

并将文件复制到您的 bin 文件夹

sudo cp start-discourse /usr/bin/

完成了。 现在，每次打开 Ubuntu bash 时，只需运行下面的命令即可开始开发：

start-discourse

---

或者，如果您使用的是 Windows 10 企业版、专业版或教育版，则可以在 hyper-v 中创建 Linux 虚拟机来设置 Discourse 开发环境。

关于 Windows 环境的备注

截至 2020 年 6 月 30 日：

@AndreaHabib

随着 Windows 10 版本 2004 和 WSL 2 的推出，许多人可能会遇到一些问题，因为 Discourse 现在实际上需要 WSL 2 才能运行。
首先： 如果您尚未更新，请将系统更新到 Windows 2004 (19041)
注意：请勿在系统设置中使用 Windows 更新进行安装，因为这可能会导致安装中途出错。另外，请确保您处于 Windows 1903 (18362) 或 1909 (18363) 版本，您可以搜索 winver 来确认。

• 前往：下载 Windows 10
• 点击“Windows 10 2020 年 5 月更新”下的“立即更新”按钮以下载更新助手并让其安装完成
• 如果出现任何错误，请下载媒体创建工具，运行它，创建一个可启动的闪存驱动器（至少 8GB），并使用它来安装 Windows。

完成 Windows 安装后，您需要手动安装 WSL 2
但首先，我们需要确保启用了以下两个功能：

• 虚拟机平台：可以直接从 Windows 启用，进入“程序和功能”，然后在“启用或关闭 Windows 功能”中启用可选功能
• 另一个是虚拟化，只能从 BIOS 中启用。不过此选项可能因主板而异。例如：在 AMD 上它被称为 SVM。因此请查找您特定的主板。

既然您已经启用了这两个功能：

• 安装 Ubuntu 18.04，而不是 20.04，因为在 20.04 上某些安装会失败。
• 前往此处更新 Linux 内核：链接在回复中
• 前往此链接并按照步骤操作：在 Windows 10 上安装适用于 Linux 的 Windows 子系统 (WSL) | Microsoft Docs
• 打开 PowerShell（以管理员身份运行）并运行：wsl --set-version Ubuntu-18.04 2 或 wsl --set-version Ubuntu 2，具体取决于 wsl -l -v 中显示的发行版
• 转换需要一些时间，几分钟
• 运行 wsl -l -v 以确保 Ubuntu 正在 WSL 2 上运行

现在您可以运行 Ubuntu-18.04 或带有 Ubuntu 的 Windows 终端，并开始安装依赖项和工具

注意：如果在 bundle install 期间安装某个 gem 时遇到错误：请确保您使用的是 Ubuntu-18.04 而不是 20.04

但是，如果您已经运行了 postgreSQL 12 并且端口为 5432，可能会遇到一些问题，因为依赖项安装的是 PostgreSQL 10，这可能会将端口增加到 5433。
要解决此问题：

• 在文本编辑器（例如 VS Code）中打开您的文件夹
• 进入 config/database.yml
• 在 development 和 adapter 下，添加一个新行，然后添加：port: 5433
• 确保对 test 和 profile 也执行相同的操作。

如果上述方法不起作用，请确保检查 PostgreSQL 是否正在运行以及运行在哪个端口，通过 pg_isready。然后按照上述相同的说明，将端口设置为数据库运行的端口。

关于 LINUX KERNEL：更新 WSL 2 Linux 内核 | Microsoft Docs

@RickyC0626

一种不需要在 database.yml 中显式配置端口的解决方案

在数据库创建和迁移期间的一些错误：

无效的 Redis 特定端口连接 / 连接被拒绝

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Caused by:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Caused by:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(See full trace by running task with --trace)

从该错误中我们可以看到 Redis 使用的端口是 6379，我们可以通过该端口启动 Redis 服务器来修复此问题。

默认情况下，redis-server --daemonize yes 应该可以工作，但如果不行，请使用：

redis-server --daemonize yes --port 6379

检查 Redis 实例状态：

redis-cli

127.0.0.1:6379> ping
PONG

无效的 psql 端口连接

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

从该错误中我们可以看到 PostgreSQL 在连接端口 5432 时遇到了问题。通常启动服务即可解决

sudo service postgresql start

如果这仍然不起作用且错误持续存在，请尝试检查服务正在监听哪个端口，并在必要时在 postgresql.conf 中将端口更改为您想要的端口：

pg_isready

/var/run/postgresql:5432 - no response
or
/var/run/postgresql:5432 - accepting connections

---

结果

一旦我们完成了上述操作或执行了 start-discourse 命令，这两个实例应该会在其默认/指定端口上运行。要检查它们在默认 Windows cmd 终端中的状态，我们可以运行：

netstat -anop tcp

这将显示类似以下内容：

Proto    Local Address        Foreign Address        State            PID
TCP      127.0.0.1:5432       0.0.0.0:0              LISTENING        17768
TCP      127.0.0.1:6379       0.0.0.0:0              LISTENING        17768

我们现在已确认我们的 postgresql 和 redis-server 实例都在运行。

我们还可以使用以下命令检查 Ubuntu 或 WSL 上实例的状态：

lsof -i

COMMAND     PID        USER  FD  TYPE  DEVICE  SIZE/OFF  NODE  NAME
mailcatch  3244  rickyc0626  7u  IPv4   36127       0t0   TCP  localhost:1025 (LISTEN)
mailcatch  3244  rickyc0626  8u  IPv4   36128       0t0   TCP  *:socks (LISTEN)
redis-ser  3287  rickyc0626  6u  IPv6   29352       0t0   TCP  *:6379 (LISTEN)
redis-ser  3287  rickyc0626  7u  IPv6   29353       0t0   TCP  *:6379 (LISTEN)

---

sudo ss -plunt | grep postgres

tcp  LISTEN  0  128  127.0.0.1:5432  0.0.0.0:*  users:(("postgres",pid=3070,fd=7))

---

pg_lsclusters

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log

---

从这里开始，这些命令应该可以正常工作，无需修改 database.yml 文件：

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

任何后续出现的问题都可以留待以后解决。

截至 2020 年 7 月 1 日

@RickyC0626

一种不需要在 database.yml 中显式配置端口的解决方案

在数据库创建和迁移期间的一些错误：

无效的 Redis 特定端口连接 / 连接被拒绝

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Caused by:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Caused by:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(See full trace by running task with --trace)

从该错误中我们可以看到 Redis 使用的端口是 6379，我们可以通过该端口启动 Redis 服务器来修复此问题。

默认情况下，redis-server --daemonize yes 应该可以工作，但如果不行，请使用：

redis-server --daemonize yes --port 6379

检查 Redis 实例状态：

redis-cli

127.0.0.1:6379> ping
PONG

无效的 psql 端口连接

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

从该错误中我们可以看到 PostgreSQL 在连接端口 5432 时遇到了问题。通常启动服务即可解决

sudo service postgresql start

如果这仍然不起作用且错误持续存在，请尝试检查服务正在监听哪个端口，并在必要时在 postgresql.conf 中将端口更改为您想要的端口：

pg_isready

/var/run/postgresql:5432 - no response
or
/var/run/postgresql:5432 - accepting connections

---

结果

一旦我们完成了上述操作或执行了 start-discourse 命令，这两个实例应该会在其默认/指定端口上运行。要检查它们在默认 Windows cmd 终端中的状态，我们可以运行：

netstat -anop tcp

这将显示类似以下内容：

Proto    Local Address        Foreign Address        State            PID
TCP      127.0.0.1:5432       0.0.0.0:0              LISTENING        17768
TCP      127.0.0.1:6379       0.0.0.0:0              LISTENING        17768

我们现在已确认我们的 postgresql 和 redis-server 实例都在运行。

我们还可以使用以下命令检查 Ubuntu 或 WSL 上实例的状态：

lsof -i

COMMAND     PID        USER  FD  TYPE  DEVICE  SIZE/OFF  NODE  NAME
mailcatch  3244  rickyc0626  7u  IPv4   36127       0t0   TCP  localhost:1025 (LISTEN)
mailcatch  3244  rickyc0626  8u  IPv4   36128       0t0   TCP  *:socks (LISTEN)
redis-ser  3287  rickyc0626  6u  IPv6   29352       0t0   TCP  *:6379 (LISTEN)
redis-ser  3287  rickyc0626  7u  IPv6   29353       0t0   TCP  *:6379 (LISTEN)

---

sudo ss -plunt | grep postgres

tcp  LISTEN  0  128  127.0.0.1:5432  0.0.0.0:*  users:(("postgres",pid=3070,fd=7))

---

pg_lsclusters

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log

---

从这里开始，这些命令应该可以正常工作，无需修改 database.yml 文件：

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

任何后续出现的问题都可以留待以后解决。

---

最后由 @SaraDev 于 2022-06-16T02:00:00Z 审阅

---

本文档已进行版本控制 - 请在 GitHub 上提出更改建议。

[Arkshine]

@Arkshine

在全新的 Ubuntu 22（Windows 10, WSL2）和成功的 Discourse 安装上，所有图片在默认端口 4200 上都无法提供服务。

好了，找到了一个解决方案。

我注意到将 127.0.0.1 替换为 localhost 可以解决图片问题。

搜索了一下，你可以使用以下命令来启动 Discourse：

DISCOURSE_HOSTNAME=localhost UNICORN_LISTENER=localhost:3000 bin/ember-cli -u

---

我稍后会尝试更新指南。

[Arkshine]

能帮忙看看这个 PR 吗？

FIX: The PostgreSQL service not starting after installation (WSL2 context)

这样能让这个指南更友好一些。

[Will_S1 (Will S)]

在运行 bundle install 后，为什么会出现“抱歉，发生意外错误，Bundler 无法继续。”的提示？

[D111 (D)]

同样的问题

[sam (Sam Saffron)]

你能提供错误的截图吗？你安装的是什么版本的 Ruby？

[frocm]

我遇到了依赖项问题：

ux430uq@Asus-UX430UQ:~/discourse$ bundle install
You must use Bundler 2 or greater with this lockfile.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Bundler version 1.16.1

ux430uq@Asus-UX430UQ:~/discourse$ gem install bundler

Fetching: bundler-2.4.20.gem (100%)
ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /var/lib/gems/2.5.0 directory.
ux430uq@Asus-UX430UQ:~/discourse$
ux430uq@Asus-UX430UQ:~/discourse$ sudo gem install bundler
[sudo] password for ux430uq:
Fetching: bundler-2.4.20.gem (100%)
ERROR:  Error installing bundler:
        The last version of bundler (>= 0) to support your Ruby & RubyGems was 2.3.26. Try installing it with `gem install bundler -v 2.3.26`
        bundler requires Ruby version >= 2.6.0. The current ruby version is 2.5.0.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Bundler version 1.16.1
ux430uq@Asus-UX430UQ:~/discourse$

有什么简单的方法可以解决这个问题吗？我曾尝试安装 2.6.0，然后是 2.7.0，但总是遇到其他问题。

[AliBenBongo]

正如前面的一些评论所述，我在尝试遵循本指南时也遇到了一些困难和错误——在 Windows 10 和 Windows 11 桌面都进行了尝试。

经过一些反复试验，我终于找到了在 Windows 11 下成功搭建开发环境的步骤，并在最新的 22H2 版本和即将发布的 23H2 Release Preview 版本上进行了测试（我假设它也能在最新版本的 Windows 10 上运行）。

如果对大家有帮助，我刚刚在这里发布了指南：-

Guide to Setting Up Discourse Development Environment - Windows 11

Hi Everyone, After spending some time attempting to get a working development environment up and running under Windows 11 / WSL2 I thought I would share the steps that I have followed. This is my first post here so I hope that this is of use to somebody I am a Systems Administrator used to working with Windows so this has been an interesting journey learning Linux / Ruby / Discourse etc. A few things seem to have changed since the guide for Windows 10 was written and I ran into…

希望这能帮助到像我一样试图在 Windows 上运行 Discourse 的人们

[Canapin (Coin-coin le Canapin)]

我再次通读了整个官方指南，以确保在我上次尝试后没有任何东西损坏。
我在 Windows 11 上通过 WSL 安装了 Ubuntu（未指定版本），它安装了最新的 LTS 版本，即 22.04。

我没有遇到任何问题；一切都很顺利，没有错误，开发环境安装成功。

如果您将来在按照我们的官方指南安装某项内容时遇到麻烦，请记下错误并向我们报告，这总是有用的

---

不过有两个警告：

安装 Node.js 时：

================================================================================
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
================================================================================

                           脚本弃用警告


  此脚本位于 https://deb.nodesource.com/setup_X，用于
  安装 Node.js 已弃用，并将最终失效。

  请访问 NodeSource distributions GitHub 并按照
  说明迁移您的仓库。
  https://github.com/nodesource/distributions

  NodeSource Node.js Linux distributions GitHub 存储库包含
  有关支持的 Node.js 版本和 Linux 发行版的信息
  以及如何安装。
  https://github.com/nodesource/distributions


                          脚本弃用警告

================================================================================
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
================================================================================

为避免此等待，请迁移脚本
将在 60 秒后继续（按 Ctrl-C 中止）...

运行 redis-server --daemonize yes 时：

# 警告：必须启用内存超额提交！否则，在内存不足的情况下，后台保存或复制可能会失败。禁用它也可能在内存未不足的情况下导致失败，请参阅 https://github.com/jemalloc/jemalloc/issues/1328。要解决此问题，请将 'vm.overcommit_memory = 1' 添加到 /etc/sysctl.conf，然后重新启动或运行命令 'sysctl vm.overcommit_memory=1' 使其生效。

[AliBenBongo]

我不确定当时我遇到这么多问题的原因！也许是我的 Windows 安装有问题，我在故障排除过程中无意中修复了它！

不过，我仍然对到目前为止所学到的东西感到满意，并期待继续努力将我的论坛迁移到 Discourse。

[Arkshine]

@Canapin

我再次通读了整个官方指南，以确保自上次尝试以来没有任何东西损坏。

我不得不重装了 Windows，现在我安装了一个全新的 Windows 11。
我将遵循指南，稍后汇报！我也会记住 @AliBenBongo 的指南。

[Arkshine]

这是一个后续跟进。

该指南肯定需要更新，但在全新的 Windows 11 22H2 上仍然运行得非常好。

我遇到的唯一问题是，尽管 wsl 命令在终端中可用，但 WSL 功能实际上并未默认启用：

[NateDhaliwal]

我认为本指南已过时。Ubuntu/Debian 指南中提到的步骤已不存在。

[NateDhaliwal]

有什么方法可以撤销所有这些步骤，例如撤销软件包、gem 的安装脚本和克隆吗？

[TempAccount]

@Discourse

警告： 请安装 Ubuntu 18.04，而不是 20.04，因为某些安装在 20.04 上会失败。

安装 18.04 覆盖 20.04 是否仍然是必需的？

安装 nodejs 时收到错误：

# apt install nodejs

Reading package lists... Done
Building dependency tree
Reading state information... Done
Some packages could not be installed. This may mean that you have
requested an impossible situation or if you are using the unstable
distribution that some required packages have not yet been created
or been moved out of Incoming.
The following information may help to resolve the situation:

The following packages have unmet dependencies:
 nodejs : Depends: libc6 (>= 2.28) but 2.27-3ubuntu1.6 is to be installed
E: Unable to correct problems, you have held broken packages.```

[saros]

@Arkshine

了，找到了一个解决方案。

我注意到将 127.0.0.1 替换为 localhost 可以解决图片问题。

搜索了一下，你可以使用以下命令来启动 Diwsl

24.04安装失败，宿主机无法链接3000端口

[merefield (Robert)]

我在 24.04 上运行。建议分享更多关于启动服务器时各项情况的详细信息。

尝试运行 FORCE_HOSTNAME=localhost bin/ember-cli -u，这将同时启动后端和前端服务器。

（在路上：凭记忆）