Truy cập
Giao diện web: https://<SERVER_IP>
Điểm cuối API: https://<SERVER_IP>:5004
Thông tin đăng nhập admin mặc định:
- Email:
[email protected] - Mật khẩu:
1234
Thay đổi thông tin đăng nhập quản trị ngay sau lần đăng nhập đầu tiên.
Lưu ý về chứng chỉ tự ký
Bản cài đặt này sử dụng chứng chỉ TLS tự ký.
Trình duyệt sẽ hiển thị cảnh báo SSL - điều này là bình thường.
Với các lệnh gọi API sử dụng curl, bạn cần bỏ qua xác thực chứng chỉ:
curl -k https://<SERVER_IP>:5004
Cái -k Cờ này yêu cầu curl bỏ qua xác minh chứng chỉ TLS.
Ví dụ lấy token API:
curl -k https://<SERVER_IP>:5004/api/v1/auth/login
-H "Content-Type: application/json"
-d '{"email":"[email protected]","password":"1234"}'
Lệnh này trả về phản hồi JSON chứa token.
Ví dụ lấy token API:
curl -k -i https://<SERVER_IP>:5004/api/v1/<VALID_ENDPOINT>
-H "Authorization: Bearer <TOKEN>"
Trong môi trường production, hãy thay chứng chỉ tự ký bằng chứng chỉ SSL đáng tin cậy (ví dụ: Let's Encrypt).
Các file và thư mục quan trọng
- Thư mục cài đặt:
/root/peppermint - Biến môi trường (thông tin xác thực DB, secret, BASE_URL):
/root/peppermint/.env - Docker Cấu hình Compose:
/root/peppermint/docker-compose.yml - Dữ liệu persistent của PostgreSQL (Docker volume):
/var/lib/docker/volumes/pgdata/_data - Cấu hình Nginx reverse proxy:
/etc/nginx/conf.d/peppermint-client.conf&/etc/nginx/conf.d/peppermint-api.conf - Chứng chỉ TLS (tự ký hoặc Let's Encrypt):
/etc/nginx/ssl/
Kích hoạt SSL với tên miền
1. Trỏ tên miền của bạn về địa chỉ IP của máy chủ.
2. Chỉnh sửa /root/peppermint/.env để đặt tên miền của bạn: BASE_URL=https://your.domain.com
3. Tạo lại các dịch vụ:
cd /root/peppermint/
docker compose up -d
4. Chỉnh sửa cấu hình Nginx và thay server_name <IP>; với tên miền của bạn (<your-domain>) cho cả HTTP (cổng 80) và HTTPS (cổng 443) như sau:
vim /etc/nginx/conf.d/peppermint-client.conf
vim /etc/nginx/conf.d/peppermint-api.conf
5. Cài đặt Certbot:
apt install -y certbot python3-certbot-nginx
6. Chạy lệnh sau để tạo chứng chỉ Let's Encrypt hợp lệ:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
7. Thay thế đường dẫn SSL trong cấu hình Nginx (phần TLS):
vim /etc/nginx/conf.d/peppermint-client.conf
vim /etc/nginx/conf.d/peppermint-api.conf
# Before:
# ssl_certificate /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
8. Khởi động lại Nginx để áp dụng thay đổi:
systemctl restart nginx
9. Mở trình duyệt và truy cập: https://yourdomain.com
