Cài đặt bằng tệp nhị phân

Hướng dẫn thao tác

Dành cho:: Người vận hành máy chủ

Hướng dẫn này cho biết cách cài đặt ReputeCast trên Linux dưới dạng một tệp nhị phân duy nhất do systemd chạy, bên cạnh một máy chủ PostgreSQL. Tệp nhị phân chứa ứng dụng web và mọi migration cơ sở dữ liệu; bạn không cần cài thêm gì khác.

Trước khi bắt đầu

Một máy chủ Linux amd64 hoặc arm64 có systemd, và PostgreSQL 16, 17 hoặc 18 (xem yêu cầu hệ thống).
Quyền sudo và một reverse proxy cho TLS trên cùng máy chủ (reverse proxy và TLS).
Tệp nhị phân cũng chạy được trên macOS và Windows, nhưng hướng dẫn này dùng systemd.

Cài đặt ReputeCast

Tải tệp nén cho nền tảng của bạn (linux_amd64 hoặc linux_arm64) và checksums.txt từ trang phát hành, kiểm tra tệp rồi cài tệp nhị phân:

sha256sum --ignore-missing -c checksums.txt
tar -xzf reputecast_*_linux_amd64.tar.gz reputecast
sudo install -m 0755 reputecast /usr/local/bin/reputecast
reputecast version

Tạo cơ sở dữ liệu, người dùng của nó và role cho phân khúc SQL (PostgreSQL):

sudo -u postgres psql -c "CREATE ROLE reputecast LOGIN PASSWORD 'change-me'" \
  -c "CREATE DATABASE reputecast OWNER reputecast" \
  -c "CREATE ROLE reputecast_segments NOLOGIN" \
  -c "GRANT reputecast_segments TO reputecast"

Tạo một tài khoản hệ thống Linux cho dịch vụ. systemd tạo thư mục dữ liệu của nó, /var/lib/reputecast, ở bước 6:
Terminal window
```
sudo useradd --system --no-create-home --shell /usr/sbin/nologin reputecast
```

Tạo thư mục /etc/reputecast (sudo mkdir -p /etc/reputecast) và ghi cấu hình vào đó dưới dạng tệp biến môi trường, chỉ root và dịch vụ đọc được:

REPUTECAST_DATABASE__URL=postgres://reputecast:change-me@localhost:5432/reputecast?sslmode=disable
REPUTECAST_HTTP__PUBLIC_URL=https://news.example.com
REPUTECAST_HTTP__ADDR=127.0.0.1:8080
REPUTECAST_HTTP__TRUSTED_PROXIES=127.0.0.1
REPUTECAST_SECRETS__KEY_FILE=/var/lib/reputecast/secret.key
REPUTECAST_LOG__FORMAT=json

sudo chown root:reputecast /etc/reputecast/env && sudo chmod 0640 /etc/reputecast/env

Nếu không có REPUTECAST_SECRETS__KEY_FILE, tệp khóa sẽ là data/secret.key trong thư mục làm việc. Mọi khóa cấu hình được mô tả trong cấu hình ReputeCast.

Áp dụng migration và tạo Chủ sở hữu đầu tiên:

sudo sh -c 'set -a && . /etc/reputecast/env && reputecast install --email [email protected] --name "Your Name"'

  ReputeCast is installed.

  Sign in at  https://news.example.com
  Email       [email protected]
  Password    HAwc-PKEn-jSXh-EE9w   (temporary: you'll replace it at first sign-in)

install chỉ ghi vào cơ sở dữ liệu. Lệnh dừng với ReputeCast is already installed: users exist khi cơ sở dữ liệu đã có người dùng.

Tạo dịch vụ:

[Unit]
Description=ReputeCast
After=network-online.target postgresql.service
Wants=network-online.target

[Service]
Type=simple
User=reputecast
Group=reputecast
EnvironmentFile=/etc/reputecast/env
ExecStart=/usr/local/bin/reputecast serve
Restart=on-failure
StateDirectory=reputecast
WorkingDirectory=/var/lib/reputecast

[Install]
WantedBy=multi-user.target

StateDirectory=reputecast khiến systemd tạo /var/lib/reputecast thuộc sở hữu của người dùng dịch vụ. Ở lần khởi động đầu tiên, ReputeCast ghi khóa bí mật vào đó và lưu tệp tải lên trong /var/lib/reputecast/files.

Khởi động dịch vụ:

sudo systemctl daemon-reload
sudo systemctl enable --now reputecast

Trỏ reverse proxy đến 127.0.0.1:8080, mở URL công khai và hoàn tất lần đăng nhập đầu tiên.

Kiểm tra kết quả

systemctl status reputecast hiện active (running).
journalctl -u reputecast có một dòng http listening kèm địa chỉ, URL công khai và các vai trò.
curl http://127.0.0.1:8080/readyz trả về ready.
sudo sh -c 'set -a && . /etc/reputecast/env && reputecast migrate status' không liệt kê migration nào là pending.

Khắc phục sự cố

Error: http.public_url must be an absolute URL, got "…": hãy viết địa chỉ kèm scheme, https://news.example.com.
Log cảnh báo database has pending migrations: serve không chạy migration trừ khi bạn truyền --auto-migrate. Hãy chạy reputecast migrate up với cùng môi trường, hoặc thêm --auto-migrate vào ExecStart.
connect to postgres: …: hãy kiểm tra URL, mật khẩu và pg_hba.conf bằng psql với cùng URL.
Lỗi permission denied khi đọc khóa bí mật: /var/lib/reputecast phải thuộc về người dùng dịch vụ; hãy giữ StateDirectory=reputecast trong unit.
Mất mật khẩu tạm thời: reputecast user reset-password --email [email protected] in ra một liên kết dùng một lần (khôi phục quyền truy cập).