Khắc phục sự cố
Xử lý các vấn đề thiết lập, kết nối, định tuyến, subscription, asset và logging của Tunna.
Dùng trang này như runbook. Hãy bắt đầu với một nút đã biết và định tuyến đơn giản, thực hiện một lần thử sạch, rồi đọc các dữ kiện mới nhất Tunna cung cấp. Phần lớn vấn đề đến từ nút đã chọn, kế hoạch định tuyến, Apple Network Extension, cập nhật nhà cung cấp, assets, imports hoặc log quá yên lặng.
Bắt đầu từ triệu chứng, không phải mọi cài đặt
Chọn nhánh khớp với điều bạn có thể tái hiện một lần, rồi thu thập bằng chứng Tunna mới nhất trước khi đổi thêm trường.
Hãy dùng các thẻ này như bản đồ các nhãn hiển thị trong màn hình này. Mỗi thẻ nêu một trường, điều khiển hoặc trạng thái và giải thích mục đích trước khi bạn thay đổi hoặc dựa vào nó.
Lựa chọn hiển thị
Đây là các điều khiển, trạng thái hoặc phép đo trong màn hình. Hãy đọc như tham chiếu, không phải cam kết tính năng.
Tunnel không giữ trạng thái chạy
Kiểm tra Power thủ công, trạng thái Apple Network Extension, một nút đã chọn và các hàng log mới nhất.
Lưu lượng dùng sai tuyến
Kiểm tra thứ tự rule, trạng thái paused, Default Route, Proxy so với Freedom, và liệu điều kiện có thể khớp lưu lượng đó hay không.
Subscription hoặc asset đã cũ
Kiểm tra trạng thái fetch, metadata nhà cung cấp, thời điểm cập nhật, trạng thái xử lý asset và Resources có đang chờ review hay không.
Log hoặc stats quá yên lặng
Tái hiện một lần sạch, rồi so sánh Log, Debug, Observability, độ trễ, packet loss và bộ đếm dữ liệu.
Cần hỗ trợ từ cộng đồng?
Đăng một báo cáo tập trung sau khi bạn tái hiện sự cố một lần. Bao gồm phiên bản Tunna, nút là cục bộ hay từ đăng ký, protocol đã chọn, tuyến mong đợi và các bản ghi log mới nhất sau lần thử.
Che UUIDs, passwords, Reality keys, node links và subscription URLs trước khi chia sẻ.
Lượt kiểm tra đầu tiên cho mọi sự cố kết nối
Triệu chứng thường gặp
| Triệu chứng | Kiểm tra trước | Cách thử |
|---|---|---|
| Không có Node nào khả dụng | Outbound và Subscriptions | Thêm một nút cục bộ, quét hoặc dán liên kết nút, hoặc cập nhật hồ sơ đăng ký. |
| Không thể kết nối | Protocol, transport và security | So sánh nút với hồ sơ nhà cung cấp. Server Name và Address thường khác nhau. |
| Save bị vô hiệu hóa | Các trường nút thủ công | Điền các giá trị address, port và credential bắt buộc cho protocol đã chọn. |
| Tunnel khởi động rồi dừng | Các bản ghi log mới nhất | Xóa log, bật Debug cho một lần thử, khởi động thủ công, rồi đọc các bản ghi mới nhất để tìm lỗi khởi động đầu tiên hoặc xung đột cấu hình. |
| Tunnel không khởi động | Cấu hình nút và tuyến | Dùng Debug cho một lần tái hiện. Xung đột thường có nghĩa là nút, transport, security, route, DNS hoặc cài đặt đường hầm đã chọn không mô tả cùng một thiết lập nhất quán. |
| Power có vẻ bị kẹt | Trạng thái Network Extension | Nếu điều khiển Power đang hiển thị vẫn nhận thao tác nhấn giữ trong lúc còn connecting hoặc disconnecting, hãy dùng thao tác đó để khởi tạo lại Network Extension. Nếu Power đang tắt, thất bại, im lặng hoặc không thể nhấn giữ, hãy dùng màn hình Reset. |
| Lưu lượng không đi qua Proxy | Định tuyến | Xác nhận Default Route là Proxy, hoặc thêm một quy tắc Proxy phía trên các quy tắc đi trực tiếp rộng hơn. |
| Đã kết nối nhưng trang vẫn không tải | Luồng lưu lượng | Thử một nút đã biết với Default Route đặt là Proxy, rồi dùng ghi log Access hoặc DNS cho một lần thử nếu route hoặc tra cứu tên chưa rõ. |
| Thiết bị cục bộ biến mất | Mạng nội bộ | Kiểm tra xem lưu lượng subnet riêng có nên đi vào đường hầm VPN hay không. Thử một router, máy in, NAS hoặc địa chỉ dịch vụ cục bộ. |
| Chỉ rule DNS, TLS, HTTP, QUIC hoặc giao thức ứng dụng bị lỗi | Sniffing và Domain Strategy | Trước tiên hãy dùng một quy tắc domain đơn giản, rồi chỉ bật những tính năng nhận diện mà quy tắc thật sự cần. |
| Trang web thay đổi sau khi bật IPv6 | IPv6 route plan | Tắt IPv6 và lặp lại cùng bài kiểm tra trang web. Chỉ bật lại khi mạng, nhà cung cấp, quy tắc và asset đều hỗ trợ đường đi đó. |
| Một quy tắc không khớp | Thứ tự quy tắc và điều kiện | Đưa quy tắc lên cao hơn, bỏ tạm dừng, kiểm tra loại domain và dùng Sniffing cho các quy tắc dựa trên protocol ứng dụng. |
| Quy tắc asset không tìm thấy bản ghi | Asset đã cài đặt | Thêm asset định sẵn hoặc cập nhật asset từ xa, chờ xử lý hoàn tất, rồi tìm lại trong tab Asset. |
| Subscription bị lỗi, hết hạn hoặc đã cũ | Chân trạng thái, mạng và source URL | Kiểm tra kết nối, provider URL, user agent, thời hạn của nhà cung cấp và xem profile đã tải còn chứa liên kết nút dùng được hay không. |
| Import bị tắt trong Resources | Lựa chọn và các lần tải đang chờ | Chọn ít nhất một phần tử, rồi chờ các nút subscription hoặc rule asset tải xong. Bỏ chọn các phần tử lỗi hoặc không muốn dùng trước khi import. |
| Không tìm thấy nhật ký | Điều khiển Log | Tăng severity, chỉ bật Access hoặc DNS cho bài kiểm tra, tái hiện sự cố, rồi giảm mức chi tiết của log. |
| Mức dùng pin, dữ liệu hoặc dung lượng có vẻ cao | Log và probe | Tắt ghi log Debug, Access và DNS sau bài kiểm tra. Kéo dài khoảng cách probe hoặc giảm concurrency khi bạn không chủ động so sánh các nút. |
| Bản cập nhật nhà cung cấp đã thay đổi routing | Dọn dẹp subscription | Xem lại các quy tắc trỏ tới nút subscription sau khi lần làm mới từ nhà cung cấp xóa hoặc đổi tên nút. |
Câu hỏi thường gặp
Hãy xem đây là phiên bản rút gọn của hướng dẫn. Mỗi câu trả lời chỉ tới màn hình hoặc nhóm cài đặt chịu trách nhiệm cho việc đó.
Khởi động và import
Nút và nhà cung cấp
Quyết định routing
Asset và khớp điều kiện
Hành vi đường hầm
Log, kiểm tra và thống kê
Đặt lại và hỗ trợ
Dùng Reset cẩn thận
"Đặt lại tiện ích mở rộng mạng" dựng lại cấu hình VPN của hệ thống. "Đặt Lại Dữ Liệu Người Dùng" có thể xóa các cài đặt ứng dụng đã chọn và không thể hoàn tác. Hãy ưu tiên các tùy chọn đặt lại có phạm vi cụ thể thay vì "Đặt lại tất cả".
Ý nghĩa của Power thay đổi theo trạng thái đường hầm
Dùng thao tác chạm và nhấn giữ phù hợp với trạng thái thật của Tunna. Nhấn giữ là thao tác tiện lợi khi đường hầm khỏe mạnh, và chỉ là thao tác khôi phục khi đường hầm bị kẹt.
Hãy dùng các thẻ này như bản đồ các nhãn hiển thị trong màn hình này. Mỗi thẻ nêu một trường, điều khiển hoặc trạng thái và giải thích mục đích trước khi bạn thay đổi hoặc dựa vào nó.
Lựa chọn hiển thị
Đây là các điều khiển, trạng thái hoặc phép đo trong màn hình. Hãy đọc như tham chiếu, không phải cam kết tính năng.
Lần chạm đầu tiên
Khi chưa có cấu hình VPN hệ thống, lần chạm Power đầu tiên sẽ cài đặt cấu hình Apple Network Extension của Tunna. Hãy phê duyệt lời nhắc VPN của hệ thống trước khi kỳ vọng lưu lượng đi qua.
Đã kết nối với Always On
Nhấn giữ sẽ tắt Always On và dừng đường hầm. Thao tác này không tắt On-Demand. Nếu On-Demand gây vòng lặp khởi động lại, hãy đặt Connect về Never trong cài đặt Tunnel khi chẩn đoán.
Đã ngắt kết nối trên mạng tin cậy
Nhấn giữ chỉ có thể đánh dấu mạng tin cậy hiện tại là không tin cậy khi Power đang disconnected. Nếu đường hầm vẫn kết nối trên mạng tin cậy, hãy chờ tự ngắt, đặt chế độ auto-connect liên quan về Never khi chẩn đoán, hoặc xóa mạng đó khỏi Trusted Networks.
Đang connecting hoặc disconnecting
Nếu Power vẫn ở trạng thái connecting hoặc disconnecting và điều khiển đang hiển thị nhận thao tác nhấn giữ, hãy nhấn giữ Power để khởi tạo lại Network Extension. Nếu Power đang tắt, thất bại, im lặng hoặc không thể nhấn giữ, hãy dùng màn hình Reset.
Các tùy chọn Reset User Data bằng lời dễ hiểu
Chỉ reset phần đang lỗi. Reset All đưa dữ liệu ứng dụng Tunna về trạng thái như mới cài và chỉ nên là lựa chọn cuối cùng.
Hãy dùng các thẻ này như bản đồ các nhãn hiển thị trong màn hình này. Mỗi thẻ nêu một trường, điều khiển hoặc trạng thái và giải thích mục đích trước khi bạn thay đổi hoặc dựa vào nó.
Kế hoạch lưu lượng
Các tùy chọn này ảnh hưởng đến thứ Tunna dùng để kết nối và cách phân loại lưu lượng.
Định tuyến
Xóa kế hoạch route của bạn và đưa hành vi quy tắc về thiết lập mặc định.
Kết nối ra
Xóa các nút đã lưu và khôi phục những entry direct, block và DNS tích hợp sẵn. Các quy tắc từng trỏ tới nút bị xóa có thể rơi về nút Proxy hiện tại, nên hãy tạm dừng hoặc gán lại các quy tắc đó trước khi kết nối lại. Reset Routing thêm nếu bạn muốn xóa cả kế hoạch route.
Đăng ký
Xóa profile nhà cung cấp và các nút subscription của họ. Các quy tắc từng trỏ tới những nút đó có thể rơi về nút Proxy hiện tại, nên hãy tạm dừng hoặc gán lại chúng trước khi kết nối lại. Reset Routing thêm nếu bạn muốn xóa cả kế hoạch route.
Tài sản
Xóa các bản ghi GeoSite và GeoIP. Những quy tắc chỉ phụ thuộc vào các bản ghi đó sẽ bị tạm dừng để không trở thành quy tắc rỗng quá rộng.
Hành vi đường hầm
Các tùy chọn này đưa nhận diện kết nối và mặc định đường hầm về giá trị ban đầu.
Đường hầm
Đặt lại các lựa chọn Connect và Disconnect, mạng tin cậy, điều khiển định tuyến mạng và hành vi IPv6.
Phân tích gói tin
Đặt lại nhận diện đích, domain bị loại trừ, hành vi chỉ dùng metadata và hành vi chỉ định tuyến.
Luồng vào
Đưa điểm vào cục bộ mà Tunna dùng bên trong đường hầm về dạng mặc định.
Chính sách
Đưa hành vi timeout, buffer và chính sách tài nguyên về mặc định.
Giao thức
Đưa multiplexing cùng các mặc định Freedom, Blackhole và DNS về trạng thái mặc định. Các nút proxy hiện có vẫn giữ định danh máy chủ; những nút đủ điều kiện nhận hành vi multiplexing mặc định.
Bản ghi chẩn đoán
Các tùy chọn này ảnh hưởng đến dữ liệu Tunna đã ghi nhớ khi kiểm tra hoặc giải thích hành vi.
Nhật ký
Đưa các lựa chọn chi tiết log về mặc định.
Khả năng quan sát
Xóa lịch sử health-check và bản ghi sử dụng/độ trễ, rồi đưa cài đặt kiểm tra về mặc định.
Khi đường hầm khởi động rồi dừng hoặc không khởi động
Dùng phần này khi Power có vẻ bắt đầu đường hầm nhưng rơi về disconnected, hoặc khi đường hầm từ chối khởi động. Đích đến là một lần thử mới và lỗi hữu ích đầu tiên.
Đặt lại Apple Network Extension khi đường hầm bị kẹt
Dùng phần này cho cấu hình VPN hệ thống bị cũ hoặc rối trạng thái. Nó không sửa profile nút sai; hãy kiểm tra nút và routing trước.
Thông tin hữu ích cho hỗ trợ
- Phiên bản ứng dụng Tunna trong About.
- Bạn đang hỏi cộng đồng Tunna hay dùng liên kết hỗ trợ của nhà cung cấp từ một subscription profile.
- Nút là cục bộ hay đến từ subscription.
- Tên protocol, transport và security đã chọn.
- Default Route và tên của bất kỳ quy tắc nào bạn mong đợi sẽ khớp.
- Sự cố chỉ xảy ra trên Wi-Fi, mạng di động hay mạng tin cậy.
- Các entry log mới nhất sau khi tái hiện sự cố.
- Có subscription update, asset update, chỉnh sửa quy tắc, import hoặc reset ngay trước khi sự cố xuất hiện hay không.
- Vấn đề đến từ liên kết đã dán, mã QR, liên kết chia sẻ hệ thống, liên kết lệnh hay Siri shortcut.
- Debug có hiển thị Configuration Not Found, Configuration Parse Failed hoặc Configuration Load Failed hay không.
Màn hình hỗ trợ trong Misc
Chỉ dùng các phần này khi những kiểm tra thông thường trong Outbound, Routing, Tunnel, Subscriptions, Assets, Observability và Log không giải thích được vấn đề.
Hãy dùng các thẻ này như bản đồ các nhãn hiển thị trong màn hình này. Mỗi thẻ nêu một trường, điều khiển hoặc trạng thái và giải thích mục đích trước khi bạn thay đổi hoặc dựa vào nó.
Lựa chọn hiển thị
Đây là các điều khiển, trạng thái hoặc phép đo trong màn hình. Hãy đọc như tham chiếu, không phải cam kết tính năng.
Giới thiệu
Dùng Application Version khi báo cáo vấn đề. Community mở liên kết cộng đồng Tunna.
Đặt lại
Danger Zone chứa Reset Network Extension và Reset User Data. Tunna cảnh báo rằng các cài đặt ứng dụng đã chọn không thể khôi phục sau khi reset.
Gỡ lỗi
Debug hiển thị cấu hình đang chạy dưới dạng JSON có thể mở rộng. Chỉ nhấn giữ một hàng để sao chép phần JSON đó khi bộ phận hỗ trợ yêu cầu.
Che thông tin bí mật trước khi chia sẻ
Khi gửi ảnh chụp màn hình hoặc log, hãy che mật khẩu nút, UUID, subscription URL, khóa REALITY và mọi liên kết có thể cho phép người khác dùng máy chủ của bạn.
Tắt Debug lại
Dùng Debug cho một lần tái hiện rõ ràng hoặc khi bộ phận hỗ trợ yêu cầu. Sau đó giảm severity lại và tắt Access hoặc DNS trừ khi bạn vẫn cần chúng. Debug rất nhiều nhiễu và tốn pin, dung lượng, dữ liệu.