Bỏ qua

Cài đặt TrueNAS

Hướng dẫn này giải thích cách thiết lập Gramps Web trên TrueNAS Community Edition 25.04.

Warning

Hướng dẫn này dành cho TrueNAS Community Edition 25.04 hoặc phiên bản mới hơn, đã giới thiệu một hệ thống ứng dụng mới dựa trên Docker Compose. Nó không áp dụng cho các phiên bản trước của TrueNAS.

Các yêu cầu trước

  • TrueNAS Community Edition 25.04 hoặc phiên bản mới hơn
  • Kiến thức cơ bản về giao diện web của TrueNAS
  • Một dataset để lưu trữ dữ liệu Gramps Web

Tổng quan

TrueNAS Community Edition 25.04 đã giới thiệu một hệ thống ứng dụng mới dựa trên Docker Compose thay thế cho phương pháp dựa trên Helm chart trước đó. Hướng dẫn này sẽ hướng dẫn bạn tạo một ứng dụng tùy chỉnh cho Gramps Web bằng cách sử dụng Docker Compose.

Bước 1: Chuẩn bị Lưu trữ

  1. Điều hướng đến Datasets trong giao diện web của TrueNAS
  2. Tạo một dataset mới cho Gramps Web (ví dụ: grampsweb). Ghi lại đường dẫn đầy đủ đến dataset này, ví dụ: /mnt/storage/grampsweb, vì bạn sẽ cần nó sau này.

Tạo các thư mục con cho các thành phần khác nhau: - users - Cơ sở dữ liệu người dùng - database - Tệp cơ sở dữ liệu Gramps - media - Tệp phương tiện

Bước 2: Tạo Ứng dụng Docker Compose

  1. Điều hướng đến Apps trong giao diện web của TrueNAS
  2. Nhấp vào Discover Apps
  3. Tìm kiếm "Gramps Web" và nhấp vào nó
  4. Nhấp vào "Install"

Điều này sẽ đưa bạn đến trang cấu hình ứng dụng.

Bước 3: Cấu hình Ứng dụng

Cấu hình Gramps Web

  • Múi giờ: Đặt thành múi giờ địa phương của bạn (ví dụ: Europe/Berlin)
  • Mật khẩu Redis: Đặt một mật khẩu cho Redis. Mật khẩu này chỉ được sử dụng nội bộ bởi ứng dụng.
  • Tắt telemetry: vui lòng để ô này không được chọn – xem ở đây để biết chi tiết.
  • Khóa bí mật: điều quan trọng là bạn phải đặt giá trị này thành một giá trị mạnh và duy nhất. Xem cấu hình máy chủ để biết hướng dẫn cách tạo một khóa ngẫu nhiên.
  • Biến môi trường bổ sung: Bạn sẽ cần đặt tất cả các tùy chọn cấu hình bổ sung dưới dạng biến môi trường có tiền tố GRAMPSWEB_. Vui lòng kiểm tra tài liệu cấu hình một cách chi tiết – chẳng hạn như thực tế rằng các giá trị boolean cần được đặt là true hoặc false (tất cả chữ thường) trong trường hợp biến môi trường, một cạm bẫy phổ biến.

Vui lòng ít nhất đặt GRAMPSWEB_BASE_URL thành URL mà phiên bản Gramps Web của bạn sẽ có thể truy cập – điều này là cần thiết cho hoạt động đúng.

Bạn cũng có thể muốn thiết lập cấu hình email tại giai đoạn này. Nếu bạn làm như vậy, bạn có thể bỏ qua bước cấu hình email trong trình hướng dẫn onboarding. Các biến môi trường liên quan là:

  • GRAMPSWEB_EMAIL_HOST
  • GRAMPSWEB_EMAIL_HOST_USER
  • GRAMPSWEB_EMAIL_HOST_PASSWORD
  • GRAMPSWEB_DEFAULT_FROM_EMAIL

Tất cả các cài đặt cấu hình có thể được thay đổi sau bằng cách nhấp vào "Edit" trong giao diện TrueNAS Apps.

Cấu hình Lưu trữ

  • Lưu trữ Người dùng: Chọn đường dẫn đến thư mục users mà bạn đã tạo trước đó.
  • Lưu trữ Chỉ mục: Bạn có thể để cài đặt mặc định "ixVolume (Dataset được tạo tự động bởi hệ thống)"
  • Lưu trữ Bộ nhớ Cache Hình thu nhỏ: Bạn có thể để cài đặt mặc định "ixVolume (Dataset được tạo tự động bởi hệ thống)"
  • Lưu trữ Cache: Bạn có thể để cài đặt mặc định "ixVolume (Dataset được tạo tự động bởi hệ thống)"
  • Lưu trữ Phương tiện: Chọn đường dẫn đến thư mục media mà bạn đã tạo trước đó.
  • Lưu trữ Cơ sở dữ liệu Gramps: Chọn đường dẫn đến thư mục database mà bạn đã tạo trước đó.

Cấu hình Tài nguyên

Chúng tôi khuyên bạn nên phân bổ ít nhất 2 CPU và 4096 MB RAM để đảm bảo hoạt động mượt mà.

Bước 4: Truy cập Gramps Web

Khi ứng dụng đã được triển khai, bạn có thể truy cập Gramps Web bằng cách nhấp vào nút "Web UI" trong giao diện TrueNAS Apps. Bạn sẽ thấy trình hướng dẫn onboarding "Chào mừng đến với Gramps Web".

Nếu bạn muốn cho phép người dùng truy cập giao diện Gramps Web của bạn, không công khai ứng dụng trực tiếp ra internet, mà hãy tiếp tục bước tiếp theo.

Bước 5: Thiết lập Proxy Ngược

Để công khai phiên bản Gramps Web của bạn một cách an toàn cho người dùng, chúng tôi khuyên bạn nên thiết lập một proxy ngược. Điều này cho phép bạn quản lý chứng chỉ SSL/TLS và kiểm soát quyền truy cập.

Tùy chọn dễ nhất là sử dụng ứng dụng Nginx Proxy Manager chính thức của TrueNAS. Tìm kiếm ứng dụng trong giao diện TrueNAS Apps và cài đặt nó. Bạn có thể để tất cả các cài đặt ở mặc định, nhưng chúng tôi khuyên bạn nên đặt một biến môi trường bổ sung: DISABLE_IPV6 với giá trị true để tránh các vấn đề liên quan đến IPv6 có thể xảy ra.

Khi đã triển khai, hãy mở giao diện web của Nginx Proxy Manager và tạo một máy chủ proxy mới với các cài đặt sau:

  • Scheme: http
  • Forward Hostname / IP: tên máy chủ của máy chủ TrueNAS của bạn (ví dụ: truenas)
  • Forward Port: cổng được gán cho ứng dụng Gramps Web của bạn (kiểm tra giao diện TrueNAS Apps để biết cổng chính xác)
  • Trong tab "SSL", đánh dấu "Force SSL"
  • Dưới "SSL Certificates", chọn "Add SSL Certificate" > "Let's Encrypt" để tạo một chứng chỉ Let's Encrypt mới cho miền của bạn.

Vui lòng xem tài liệu Nginx Proxy Manager để biết thêm chi tiết về cách cấu hình router của bạn và nhận chứng chỉ SSL.