在 Windows 上安装 Discourse 用于开发

[Discourse]

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

要在 Windows 上设置 Discourse 的开发环境，你可以使用 Windows 子系统 for Linux 功能。

此设置需要安装 WSL 2。它仅适用于 Windows 10 版本 18917 或更高版本。 我们假设你已经在 Windows 10 系统上安装了 Windows 子系统 for Linux 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"
```\n
## 引导 Discourse

切换到你的 Discourse 文件夹：

```sh
cd ~/discourse
```\n
安装所需的 gems

```sh
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

尝试运行 specs：

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 Update 进行安装，因为安装过程中可能会出现错误。还要确保你使用的是 Windows 1903 (18362) 或 1909 (18363)，你可以搜索 winver 来查看。

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

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

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

现在你已经启用了这两个功能：

• 安装 Ubuntu 18.04，而不是 20.04，因为某些安装在 20.04 上会失败。
• 前往此处并更新 Linux 内核：回复中的链接
• 前往此链接并按照步骤操作：在 Windows 10 上安装 Windows 子系统 for Linux (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 也执行相同的操作。

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

关于 LINUX 内核：更新 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，这将同时启动后端和前端服务器。

（在路上：凭记忆）