Linkwarden

Truy cập

1. Mở http://<SERVER_IP>.
2. Nhấn 'Sign Up'.
3. Tạo tài khoản đầu tiên.
4. Tài khoản đầu tiên trở thành quản trị viên máy chủ vì NEXT_PUBLIC_ADMIN=1 đang được bật.

Đăng ký

Đăng ký được bật theo mặc định.

Sau khi tạo tài khoản quản trị, bạn có thể tắt đăng ký.

Để tắt, hãy sửa /root/linkwarden/.env và đặt:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Sau đó áp dụng cấu hình:

cd /root/linkwarden
docker compose up -d

Các đường dẫn quan trọng

• Đường dẫn cài đặt: /root/linkwarden
• Tệp Compose: /root/linkwarden/docker-compose.yml
• Tệp môi trường: /root/linkwarden/.env
• Dữ liệu ứng dụng: /root/linkwarden/data
• Dữ liệu PostgreSQL: /root/linkwarden/pgdata
• Dữ liệu Meilisearch: /root/linkwarden/meili_data
• Cấu hình Nginx: /etc/nginx/sites-available/linkwarden

Quản lý Docker

Kiểm tra các container:

cd /root/linkwarden
docker compose ps

Xem log:

cd /root/linkwarden
docker compose logs -f

Xem nhật ký Linkwarden:

cd /root/linkwarden
docker compose logs -f linkwarden

Khởi động lại Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

Dừng stack:

cd /root/linkwarden
docker compose down

Khởi động stack:

cd /root/linkwarden
docker compose up -d

Quản lý NGINX

Kiểm tra NGINX:

systemctl status nginx

Kiểm tra cấu hình:

nginx -t

Khởi động lại NGINX:

systemctl restart nginx

Tải lại NGINX:

systemctl reload nginx

Tên miền và HTTPS

1. Tạo một bản ghi A cho hostname của ứng dụng và trỏ nó tới địa chỉ IP công khai của máy chủ (ví dụ, app.example.com).

2. Cài đặt Certbot:

apt update
apt install -y certbot python3-certbot-nginx

3. Sửa cấu hình NGINX và thay server_name _; bằng tên miền của bạn (ví dụ, server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Kiểm tra cấu hình:

nginx -t

5. Tải lại NGINX:

systemctl reload nginx

6. Cấp một chứng chỉ TLS:

certbot --nginx -d app.example.com

7. Cập nhật các biến môi trường của Linkwarden (.env tệp):

NEXTAUTH_URL=https://app.example.com/api/v1/auth
BASE_URL=https://app.example.com

8. Sau khi đổi các biến môi trường, khởi động lại Linkwarden:

cd /root/linkwarden
docker compose down
docker compose up -d

9. Mở trình duyệt và truy cập: https://app.example.com

Ghi chú

• Linkwarden được mở công khai qua Nginx trên cổng 80.
• Bản thân ứng dụng Linkwarden chỉ lắng nghe trên 127.0.0.1:3000.
• PostgreSQL và Meilisearch là các dịch vụ Docker nội bộ và không được mở trực tiếp ra host.
• Khi cấu hình tên miền, hãy nhớ thay http:// bằng https:// ở mọi nơi URL của ứng dụng được cấu hình, bao gồm NEXTAUTH_URL và BASE_URL.
• Dùng nhất quán cùng một tên miền HTTPS trong toàn bộ cấu hình NGINX và Linkwarden.
• BASE_URL đặc biệt hữu ích khi dùng các tính năng email như đặt lại mật khẩu hoặc email xác minh.
• Thay đổi cấu hình Linkwarden theo ý bạn.