Hệ Điều Hành

Lời nói đầu

game tang 100k trai nghiem，nhà cái f8bet có

Hướng dẫn triển khai nhanh - Dịch vụ tự lưu trữ nguồn mở kích hoạt thông báo email qua Webhook

HowieHz
2025-01-21
Quản lý triển khai > Quản lý triển khai > Cấu hình công cụ
🌍 Tiếng Việt
235

Có rất nhiều dịch vụ (như ddnsgo) chỉ hỗ trợ thông báo qua Webhook và không hỗ trợ cài đặt dịch vụ email (SMTP). Bài viết này giới thiệu một dịch vụ có thể triển khai cục bộ để chuyển đổi Webhook thành thông báo qua email. Nội dung chính của bài viết là hướng dẫn cách triển khai nhanh chóng và trải nghiệm ngay lập tức.

Dưới đây là các liên kết liên quan đến dự án:

  • Địa chỉ dự án: HowieHz/webhook-email-sender.
  • Tài liệu đầy đủ của dự án.
  • Gửi phản hồi: Issues.
  • Nhóm thảo luận (QQ): Bấm vào đây để tham gia cuộc trò chuyện. Mã nhóm: 694413711.

Đặc điểm nổi bật của dự án

  • Hỗ trợ nhận yêu cầu GET và POST làm trình kích hoạt Webhook.
  • Cho phép gửi email dạng văn bản thuần túy hoặc định dạng HTML.
  • Cấu hình linh hoạt, tương thích với nhiều máy chủ SMTP khác nhau.
  • Xử lý bất đồng bộ, giúp cải thiện hiệu suất và tốc độ phản hồi.
  • Nhẹ nhàng, chiếm ít tài nguyên bộ nhớ và ổ cứng.

Triển khai nhanh trên môi trường Windows

Điều kiện tiên quyết

  • Cần có tài khoản máy chủ SMTP (ví dụ: Gmail, QQ Mail).

Quy trình triển khai và kiểm thử

  1. Truy cập trang Releases, tìm phiên bản mới nhất và tải xuống tệp nhị phân mới nhất từ mục Assets. Nhấn vào đây để tải trực tiếp webhook-email-sender.exe v1.0.0.

  2. Di chuyển tệp webhook-email-sender.exe đã tải về vào bất kỳ thư mục nào. Khi chạy tệp bằng cách nhấp đúp, nó sẽ tạo ra một tệp cấu hình mặc định tên là config.json trong cùng thư mục đang chạy.

  3. Sửa đổi config.json để cấu hình đúng.

    • Giải thích cấu hình:
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
 "SMTP_SERVER": "smtp.example.com",
 "SMTP_PORT": 587,
 "SMTP_TLS": false,
 "SMTP_USERNAME": "your_username",
 "SMTP_PASSWORD_ENV": "SMTP_PASSWORD",
 "SMTP_PASSWORD": "your_password",
 "SERVICE_HOST": "127.0.0.1",
 "SERVICE_PORT": 5000,
 "SERVICE_PATH": "/webhook",
 "SERVICE_TOKEN": ""
}
  • SMTP_SERVER: Địa chỉ máy chủ SMTP.
  • SMTP_PORT: Cổng của máy chủ SMTP.
  • SMTP_TLS: Có sử dụng mã hóa TLS hay không.
  • SMTP_USERNAME: Tên người dùng đăng nhập vào SMTP.
  • SMTP_PASSWORD_ENV: Tên biến môi trường lưu trữ mật khẩu SMTP.
  • SMTP_PASSWORD: Mật khẩu đăng nhập SMTP (nếu chưa thiết lập biến môi trường).
  • SERVICE_HOST: Máy chủ mà dịch vụ lắng nghe.
  • SERVICE_PORT: Cổng mà dịch vụ lắng nghe.
  • SERVICE_PATH: Đường dẫn Webhook.
  • SERVICE_TOKEN: Token xác thực (rời trống nếu không sử dụng).

Lưu ý: Chương trình sẽ đọc trước biến môi trường được chỉ định bởi mục SMTP_PASSWORD_ENV. Nếu biến môi trường không tồn tại, nó sẽ lấy mật khẩu từ mục SMTP_PASSWORD trong tệp cấu hình. Để đảm bảo an toàn, hãy tránh đưa tệp config.json lên kho mã nguồn công cộng.

Nếu việc gửi email thất bại, bạn có thể thử kết hợp giữa cổng 587 (với SMTP_TLS là false) hoặc cổng 465 (với SMTP_TLS là true).

  1. Chạy webhook-email-sender.exe.
  2. Mở một cửa sổ terminal mới và nhập lệnh sau để kiểm tra xem dịch vụ đã triển khai thành công hay chưa (thay thế recipient@example.com bằng địa chỉ email đích thực của bạn):
1

Invoke-WebRequest -Uri "..." -Method GET
  1. Quy trình triển khai nhanh đã hoàn tất. Vui lòng xem tài liệu đầy đủ tại đây: Tài liệu.

Triển khai nhanh trên môi trường Linux/Mac

Điều kiện tiên quyết

  • Python 3.8 trở lên.
  • Tài khoản máy chủ SMTP (ví dụ: Gmail, QQ Mail).

Quy trình triển khai và kiểm thử

  1. Clone kho mã nguồn:
1
2

git clone ...
cd webhook-email-sender
  1. Tạo và kích hoạt môi trường ảo:
1
2
3
4
5

python -m venv venv
# Trên Windows:
venv\Scripts\activate
# Trên macOS/Linux:
source venv/bin/activate
  1. Cài đặt các phụ thuộc cần thiết:
1

pip install -r requirements.txt
  1. Chạy dịch vụ lần đầu tiên để tạo tệp cấu hình mặc định:
1

python main.py

  1. Sửa đổi tệp config.json vừa được tạo để cấu hình đúng.

    • Giải thích cấu hình:
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
 "SMTP_SERVER": "smtp.example.com",
 "SMTP_PORT": 587,
 "SMTP_TLS": false,
 "SMTP_USERNAME": "your_username",
 "SMTP_PASSWORD_ENV": "SMTP_PASSWORD",
 "SMTP_PASSWORD": "your_password",
 "SERVICE_HOST": "127.0.0.1",
 "SERVICE_PORT": 5000,
 "SERVICE_PATH": "/webhook",
 "SERVICE_TOKEN": ""
}
  • Các mục cấu hình giống như phần Windows.

Lưu ý: Hãy đảm bảo rằng tệp config.json không bị chia sẻ lên kho mã nguồn công cộng vì lý do bảo mật.

  1. Khởi động dịch vụ chính thức:
1

python main.py
  1. Mở một cửa sổ terminal mới và nhập lệnh sau để kiểm tra xem dịch vụ đã triển khai thành công hay chưa (thay thế recipient@example.com bằng địa chỉ email đích thực của bạn):
1

curl "..."
  1. Quy trình triển khai nhanh đã hoàn tất. Vui lòng xem tài liệu đầy đủ tại đây: Tài liệu.

Hy vọng hướng dẫn này hữu ích cho bạn!

© 2025 Bảo Ngọc
Built with Hugo
Theme Stack thiết kế bởi Jimmy