qugalet/gotosocial
1
0
Fork 0
mirror of https://github.com/superseriousbusiness/gotosocial.git synced 2024-11-22 19:56:39 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
gotosocial/docs/locales/zh/getting_started/installation/container.md
CDN18 df6555446e
[docs] add zh docs
2024-11-02 05:58:56 +08:00

7.7 KiB
Raw Blame History

容器

本指南将指引你通过我们发布的官方容器镜像运行 GoToSocial。在本例中，我们将直接使用 Docker Compose 和 SQLite 作为数据库。

你也可以使用容器编排系统（如 Kubernetes 或 Nomad）运行 GoToSocial，但这超出了本指南的范围。

创建工作目录

你需要一个工作目录来存放你的 docker-compose 文件，以及一个目录来存储 GoToSocial 的数据。请使用以下命令创建这些目录：

mkdir -p ~/gotosocial/data

现在切换到你创建的工作目录：

cd ~/gotosocial

获取最新的 docker-compose.yaml

使用 wget 下载最新的 docker-compose.yaml 示例，我们将根据需要进行自定义：

wget https://raw.githubusercontent.com/superseriousbusiness/gotosocial/main/example/docker-compose/docker-compose.yaml

编辑 docker-compose.yaml

由于 GoToSocial 可以使用环境变量进行配置，我们可以跳过在容器中挂载 config.yaml 文件，使配置更为简单。只需编辑 docker-compose.yaml 文件以更改一些内容。

首先在你的编辑器中打开 docker-compose.yaml 文件。例如：

nano docker-compose.yaml

版本

如果需要，更新 GoToSocial Docker 镜像标签到你想要使用的 GtS 版本：

  • latest：默认值。这指向最新的稳定版本的 GoToSocial。
  • snapshot：指向当前在主分支上的代码。不保证稳定，可能经常出错。谨慎使用。
  • vX.Y.Z：发布标签。这指向 GoToSocial 的特定、稳定的版本。

!!! tip latest 和 snapshot 标签是动态标签，而 vX.Y.Z 标签是固定的。拉取动态标签的结果可能每天都会变化。同一系统上的 latest 可能与不同系统上的 latest 不同。建议使用 vX.Y.Z 标签，以便你始终确切知道运行的是 GoToSocial 的哪个版本。发布列表可以在这里找到，最新的发布在顶部。

主机

更改 GTS_HOST 环境变量为你运行 GoToSocial 的域名。

服务器时区（可选但推荐）

为确保你的 GoToSocial 服务器在贴文和日志中显示正确的时间，你可以通过编辑 TZ 环境变量设置服务器的时区。

  1. 删除环境部分中 TZ: UTC 前面的 #。
  2. 将 UTC 部分更改为你的时区标识符。有关这些标识符的列表，请参阅 https://en.wikipedia.org/wiki/List_of_tz_database_time_zones。

例如，如果你在明斯克运行服务器，你可以设置 TZ: Europe/Minsk，日本设置为 TZ: Japan，迪拜设置为 TZ: Asia/Dubai，等等。

如果不设置，将使用默认的 UTC。

用户（可选/可能不必要）

默认情况下，Docker 化的 GoToSocial 以 Linux 用户/组 1000:1000 运行，这在大多数情况下是可以的。如果你想以不同的用户/组运行，应相应地更改 docker-compose.yaml 中的 user 字段。

例如，假设你为 id 为 1001 的用户和组创建了 ~/gotosocial/data 目录。如果现在不更改 user 字段就尝试运行 GoToSocial，将会遇到权限错误，无法在目录中打开数据库文件。在这种情况下，你需要将 docker compose 文件的 user 字段更改为 1001:1001。

LetsEncrypt（可选）

如果你想为 TLS 证书（https）使用 LetsEncrypt，你还应该：

  1. 将 GTS_LETSENCRYPT_ENABLED 的值更改为 "true"。
  2. 删除 ports 部分中 - "80:80" 前面的 #。
  3. （可选）将 GTS_LETSENCRYPT_EMAIL_ADDRESS 设置为有效的电子邮件地址，以接收证书过期警告等。

!!! info "可选配置"

config.yaml 文件中记录了许多其他配置选项，你可以使用这些选项进一步自定义你的 GoToSocial 实例的行为。尽可能使用合理的默认设置，因此不一定需要立即对它们进行更改，但以下几个可能会感兴趣：

- `GTS_INSTANCE_LANGUAGES`：确定你实例首选语言的 [BCP47 语言标签](https://en.wikipedia.org/wiki/IETF_language_tag)数组。
- `GTS_MEDIA_REMOTE_CACHE_DAYS`：在存储中保持外站媒体缓存的天数。
- `GTS_SMTP_*`：允许你的 GoToSocial 实例连接到电子邮件服务器并发送通知电子邮件的设置。

如果你决定稍后设置/更改这些变量，请确保在更改后重新创建 GoToSocial 实例容器。

!!! tip

有关将 config.yaml 文件中的变量名称转换为环境变量的帮助，请参阅[配置部分](../../configuration/index.md#environment-variables)。

Wazero 编译缓存（可选）

启动时，GoToSocial 会将嵌入的 WebAssembly ffmpeg 和 ffprobe 二进制文件编译为 Wazero 兼容模块，用于媒体处理而无需任何外部依赖。

要加快 GoToSocial 的启动时间，你可以在重启之间缓存已编译的模块，这样 GoToSocial 就不必在每次启动时从头编译它们。

如果你希望在 Docker 容器中进行此操作，首先在工作文件夹中创建一个 .cache 目录以存储模块：

mkdir -p ~/gotosocial/.cache

然后，取消注释 docker-compose.yaml 文件中第二个卷的前面的 # 符号，使其从

#- ~/gotosocial/.cache:/gotosocial/.cache

变为

- ~/gotosocial/.cache:/gotosocial/.cache

这将指示 Docker 在 Docker 容器中将 ~/gotosocial/.cache 目录挂载到 /gotosocial/.cache。

启动 GoToSocial

完成这些小改动后，您现在可以使用以下命令启动 GoToSocial：

docker-compose up -d

运行此命令后，你应该会看到如下输出：

Creating network "gotosocial_gotosocial" with the default driver
Creating gotosocial ... done

如果你想跟踪 GoToSocial 的日志，可以使用：

docker logs -f gotosocial

如果一切正常，你应该会看到类似以下的内容：

time=2022-04-19T09:48:35Z level=info msg=connected to SQLITE database
time=2022-04-19T09:48:35Z level=info msg=MIGRATED DATABASE TO group #1 (20211113114307, 20220214175650, 20220305130328, 20220315160814) func=doMigration
time=2022-04-19T09:48:36Z level=info msg=instance account example.org CREATED with id 01EXX0TJ9PPPXF2C4N2MMMVK50
time=2022-04-19T09:48:36Z level=info msg=created instance instance example.org with id 01PQT31C7BZJ1Q2Z4BMEV90ZCV
time=2022-04-19T09:48:36Z level=info msg=media manager cron logger: start[]
time=2022-04-19T09:48:36Z level=info msg=media manager cron logger: schedule[now 2022-04-19 09:48:36.096127852 +0000 UTC entry 1 next 2022-04-20 00:00:00 +0000 UTC]
time=2022-04-19T09:48:36Z level=info msg=started media manager remote cache cleanup job: will run next at 2022-04-20 00:00:00 +0000 UTC
time=2022-04-19T09:48:36Z level=info msg=listening on 0.0.0.0:8080

创建你的第一个用户

现在 GoToSocial 已在运行，你应该至少为自己创建一个用户。如何创建用户可以在我们的创建用户指南中找到。

完成

GoToSocial 现在应该在你的机器上运行！要验证这一点，打开浏览器，导航到你设置的 GTS_HOST 值。你应该会看到 GoToSocial 的登陆页面。干得不错！

（可选）反向代理

如果你想在 443 端口上运行其他网络服务器或想增加额外的安全层，你可能需要使用反向代理。我们为几个流行的开源选项提供了指南，并乐意接受更多的拉取请求以增加新的指南。