MicroBin

Truy cập

Mở URL sau trong trình duyệt của bạn: https://<SERVER-IP>

Chấp nhận cảnh báo chứng chỉ tự ký và truy cập MicroBin.

Bảng quản trị

Giao diện quản trị có tại: https://<SERVER-IP>/admin/

Dùng thông tin đăng nhập sau:

• Tên người dùng: admin
• Mật khẩu: được lưu trữ trong /usr/share/microbin/.env as MICROBIN_ADMIN_PASSWORD

Cấu hình

Các thiết lập của MicroBin có thể đổi trong: /usr/share/microbin/.env

Sau khi sửa cấu hình, khởi động lại ứng dụng:

cd /usr/share/microbin
docker compose up -d

File và thư mục quan trọng

• Đường dẫn cài đặt: /usr/share/microbin
• Tệp Compose: /usr/share/microbin/compose.yaml
• Tệp môi trường: /usr/share/microbin/.env
• Volume dữ liệu: /var/lib/docker/volumes/microbin_microbin_data
• Cấu hình Nginx: /etc/nginx/sites-available/microbin

Quản lý dịch vụ

Xem các container đang chạy:

docker compose -f /usr/share/microbin/compose.yaml ps

Khởi động lại MicroBin:

docker compose -f /usr/share/microbin/compose.yaml restart

Xem nhật ký MicroBin:

cd /usr/share/microbin && docker compose logs -f

Dừng MicroBin:

docker compose -f /usr/share/microbin/compose.yaml stop

Khởi động MicroBin:

docker compose -f /usr/share/microbin/compose.yaml start

Tạo lại MicroBin:

docker compose -f /usr/share/microbin/compose.yaml up -d

Kiểm tra trạng thái Nginx:

systemctl status nginx

Khởi động lại Nginx:

systemctl restart nginx

Tải lại Nginx:

systemctl reload nginx

Xác thực cấu hình Nginx:

nginx -t

Bật HTTPS với một tên miền

1. Trỏ tên miền của bạn về IP máy chủ.

2. Chỉnh sửa /etc/nginx/sites-available/microbin và thay thế cả hai server_name _; chỉ thị bằng tên miền của bạn (ví dụ server_name yourdomain.com;).

3. Cài đặt Certbot:

apt install -y certbot python3-certbot-nginx

4. Lấy một chứng chỉ Let's Encrypt:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Chỉnh sửa /etc/nginx/sites-available/microbin và cập nhật ssl_certificate và ssl_certificate_key chỉ thị để sử dụng chứng chỉ Let's Encrypt của bạn.

Before:
    ssl_certificate /etc/nginx/ssl/microbin.crt;
    ssl_certificate_key /etc/nginx/ssl/microbin.key;
After:
    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Tải lại Nginx để áp dụng các thay đổi:

systemctl reload nginx

7. Chỉnh sửa /usr/share/microbin/.env và cập nhật MICROBIN_PUBLIC_PATH từ https://<SERVER_IP>/ thành tên miền của bạn (ví dụ export MICROBIN_PUBLIC_PATH=https://yourdomain.com/).

8. Tạo lại các dịch vụ:

cd /usr/sahre/microbin && docker compose up -d

9. Truy cập MicroBin tại https://yourdomain.com.

Ghi chú

• Việc tạo lại dịch vụ có thể ảnh hưởng tới các mục hiện có.
• Giữ lại .env an toàn, vì nó chứa các giá trị cấu hình nhạy cảm.