Khắc phục lỗi TLS, cổng SFTP và phân bổ container trên Wings daemon Pterodactyl
Bài viết hướng dẫn chi tiết từng bước khắc phục lỗi kết nối của Wings daemon Pterodactyl liên quan đến chứng chỉ TLS, cổng SFTP và phân bổ container, bao gồm kiểm tra cấu hình, lệnh...
Trong quá trình vận hành máy chủ game chuyên nghiệp với Pterodactyl Panel, lỗi kết nối giữa Pterodactyl Panel và Wings daemon là một trong những vấn đề thường gặp nhất. Lỗi này có thể biểu hiện qua thông báo "Connection failed", "TLS handshake failed", "Failed to connect to SFTP port", hoặc "Container allocation failed". Bài viết này sẽ cung cấp hướng dẫn chi tiết từng bước để khắc phục các lỗi liên quan đến chứng chỉ TLS, cổng SFTP và phân bổ container trên Wings daemon, giúp bạn khôi phục hoàn toàn hoạt động của hệ thống quản lý máy chủ game.
1. Kiểm tra trạng thái dịch vụ Wings daemon
Trước tiên, hãy xác minh rằng dịch vụ Wings daemon đang chạy trên máy chủ vật lý. Sử dụng lệnh sau để kiểm tra:
sudo systemctl status wingsNếu dịch vụ không chạy, hãy khởi động lại nó bằng lệnh:
sudo systemctl restart wingsSau khi khởi động lại, kiểm tra lại trạng thái để đảm bảo không có lỗi. Nếu dịch vụ vẫn không chạy, hãy kiểm tra nhật ký lỗi bằng lệnh:
sudo journalctl -u wings -n 50 --no-pagerNhững thông báo lỗi trong nhật ký có thể cung cấp manh mối về nguyên nhân gốc rễ, như lỗi chứng chỉ, kết nối mạng hoặc quyền truy cập.
2. Xử lý lỗi chứng chỉ TLS (TLS Handshake Failed)
Lỗi "TLS handshake failed" thường xảy ra khi Pterodactyl Panel không thể xác thực được chứng chỉ TLS của Wings daemon. Nguyên nhân phổ biến là do chứng chỉ đã hết hạn, bị thay đổi hoặc không được cấu hình đúng.
- Chứng chỉ đã hết hạn: Kiểm tra thời gian hết hạn của chứng chỉ bằng lệnh:
openssl x509 -in /etc/pterodactyl/certs/wings.crt -noout -dates. Nếu chứng chỉ đã hết hạn, hãy tạo lại chứng chỉ mới theo hướng dẫn trong phần tự động hóa chứng chỉ SSL/TLS ACME. - Chứng chỉ bị thay đổi: Nếu bạn đã thay đổi chứng chỉ trên Pterodactyl Panel hoặc Wings daemon mà không đồng bộ hóa, hãy đảm bảo rằng chứng chỉ trên cả hai bên là giống nhau. Bạn có thể kiểm tra nội dung của chứng chỉ bằng lệnh:
cat /etc/pterodactyl/certs/wings.crtvà so sánh với chứng chỉ trên Pterodactyl Panel. - Cấu hình không đúng: Kiểm tra tệp cấu hình Wings daemon tại
/etc/pterodactyl/config.yml. Đảm bảo rằng các giá trịtls,cert, vàkeyđược thiết lập chính xác. Ví dụ:
tls:
cert: /etc/pterodactyl/certs/wings.crt
key: /etc/pterodactyl/certs/wings.key3. Khắc phục lỗi cổng SFTP (Failed to connect to SFTP port)
Lỗi này thường xuất hiện khi Pterodactyl Panel không thể kết nối đến cổng SFTP trên Wings daemon để tải tệp lên máy chủ game. Nguyên nhân có thể là do tường lửa, cổng không mở hoặc dịch vụ SFTP không hoạt động.
- Kiểm tra cổng SFTP: Mở cổng 2022 trên máy chủ vật lý (hoặc cổng được cấu hình trong
config.yml). Sử dụng lệnh:sudo ufw allow 2022nếu bạn đang sử dụng UFW. - Khởi động lại dịch vụ SFTP: Đảm bảo rằng dịch vụ SFTP (thường là OpenSSH) đang chạy. Kiểm tra bằng lệnh:
sudo systemctl status ssh. Nếu không chạy, khởi động lại bằng lệnh:sudo systemctl restart ssh. - Chỉ định cổng SFTP trong config.yml: Trong tệp
/etc/pterodactyl/config.yml, kiểm tra giá trịsftp_port. Nếu không được thiết lập, hãy thêm dòng sau:
sftp_port: 20224. Giải quyết lỗi phân bổ container (Container allocation failed)
Lỗi này xảy ra khi Wings daemon không thể tạo hoặc phân bổ container cho máy chủ game mới. Nguyên nhân có thể là do không đủ tài nguyên, lỗi hệ thống tệp hoặc cấu hình Docker không đúng.
- Kiểm tra tài nguyên: Sử dụng lệnh
free -hvàdf -hđể kiểm tra RAM và dung lượng ổ đĩa còn lại. Đảm bảo rằng có đủ tài nguyên để tạo container mới. - Khởi động lại Docker: Đôi khi Docker có thể bị treo. Khởi động lại dịch vụ Docker bằng lệnh:
sudo systemctl restart docker. - Khắc phục lỗi hệ thống tệp: Nếu bạn thấy thông báo lỗi liên quan đến hệ thống tệp (ví dụ: "failed to create container"), hãy kiểm tra nhật ký Docker bằng lệnh:
sudo journalctl -u docker -n 50 --no-pager. Các lỗi phổ biến bao gồm không đủ không gian đĩa, lỗi phân vùng hoặc lỗi quyền truy cập.
Khắc phục lỗi thường gặp
| Hiện tượng lỗi | Nguyên nhân có thể | Giải pháp |
|---|---|---|
| Không thể kết nối đến Wings daemon | TLS handshake failed | Kiểm tra chứng chỉ TLS và cấu hình trong config.yml |
| Không thể tải tệp lên máy chủ | Failed to connect to SFTP port | Mở cổng 2022, khởi động lại dịch vụ SSH |
| Không thể tạo máy chủ mới | Container allocation failed | Khởi động lại Docker, kiểm tra tài nguyên hệ thống |
| Wings daemon không khởi động được | Lỗi trong nhật ký | Đọc nhật ký và xử lý lỗi cụ thể |
Lưu ý: Các bước khắc phục lỗi trên cần được thực hiện trên máy chủ vật lý. Nếu bạn đang sử dụng dịch vụ Dedicated Server của DPTCloud, hãy liên hệ với bộ phận hỗ trợ kỹ thuật để được hỗ trợ.
Sẵn sàng triển khai trên Cloud VPS NVMe Gen4 & 10Gbps?
Khởi tạo máy chủ dưới 60 giây với Anti-DDoS Anycast và cam kết Uptime 99.99%.
