Một yêu cầu hỗ trợ VPN tại nhà cần một luồng, không phải một đống cấu hình

Bạn đăng một cấu hình đã biên tập, nói rằng VPN không hoạt động, và nhận sáu câu trả lời về sáu thứ khác nhau. Vấn đề thường nằm ở yêu cầu, không phải ở người đọc. Người trợ giúp không thể từ cấu hình mà biết đường hầm không dựng được, dựng được nhưng làm rơi lưu lượng, hay chạy tốt trong khi dịch vụ tệp phía sau từ chối kết nối. Thay vào đó hãy mô tả một luồng, với ba chủ sở hữu và một lỗi đã quan sát, và câu trả lời sẽ tốt lên ngay.

Vì sao yêu cầu nhận được câu trả lời vô ích

Cấu hình mô tả cái gì đã được thiết lập. Nó không mô tả bạn đã thử gì, chuyện gì đã xảy ra, hay máy nào trong vài máy phải làm việc gì. Thiếu điều đó, mỗi người đọc đoán một giai đoạn khác nhau.

Trường hợp minh họa là một máy tính xách tay đang đi công tác, cần tới dịch vụ tệp trên máy chủ tại nhà qua cổng mạng tại nhà. Hãy nêu rõ cổng mạng, máy chủ VPN và máy chủ tệp là cùng một máy hay ba máy, vì chỉ một sự thật đó thay đổi gần như mọi câu trả lời.

Điền bản ghi này trước khi đăng

Goal: the one resource or operation that should work
Path: client -> access network -> VPN endpoint -> resource
Owners: who controls the client, the gateway and the resource
Software: product, version and protocol in use
Expected: what success would look like
Observed: exact non-secret error or response
Time and change: when it started and what changed
Control: one comparable operation that still works

Tám dòng, và hầu hết yêu cầu trở nên có thể trả lời. Dòng đối chứng là dòng người ta bỏ sót: nếu duyệt web từ cùng máy tính xách tay hoạt động trong khi chia sẻ tệp thì không, điều đó thu hẹp vấn đề vào các tuyến của đường hầm hoặc vào dịch vụ, và không ai phải hỏi.

Giữ nhãn nhất quán khi biên tập. Giữ khác biệt giữa điểm cuối công khai, địa chỉ đường hầm và mạng con tại nhà. Nếu hai dải chồng lên nhau, hãy để mối quan hệ đó hiện rõ thay vì thay mọi mạng bằng cùng một ký tự giữ chỗ, vì sự chồng lấn thường chính là câu trả lời.

Gọi tên giai đoạn lỗi, không phải toàn bộ nhật ký

Năm giai đoạn đáng tách ra: phân giải tên, thử kết nối, xác thực, thiết lập đường hầm và truy cập tài nguyên. Hãy nói bạn nghĩ giai đoạn nào lỗi và bạn thấy gì ở đó.

Dán một đoạn ngắn quanh sự kiện thay vì mọi tệp gỡ lỗi mà ứng dụng khách có thể tạo. Một trăm dòng nhiễu bắt tay che mất dòng duy nhất nói rằng tên chứng chỉ không khớp.

Tách quan sát khỏi giải thích. “Ứng dụng khách báo hết thời gian bắt tay sau 30 giây” là quan sát; “tôi nghĩ nhà cung cấp chặn UDP” là giả thuyết. Cả hai đều hữu ích, và trộn lẫn chúng khiến người trợ giúp không biết tin cái nào. Hãy gắn nhãn, và câu trả lời bạn nhận được sẽ hướng tới cái đúng.

Gửi nó cho chủ sở hữu có thể hành động

Với máy tính xách tay do công ty quản lý, hãy bắt đầu từ kênh hỗ trợ của công ty, vì diễn đàn cộng đồng không thể đổi chính sách của họ. Với dịch vụ VPN thương mại, hãy nêu sản phẩm và tài khoản ở kênh riêng, không công khai. Với cổng mạng của bạn, hãy nêu vai trò bộ định tuyến và máy chủ mà bạn kiểm soát.

Nếu dùng cộng đồng công khai, hãy chọn nơi có phạm vi hiện tại phù hợp với việc. Một chủ đề cũ về nội quy diễn đàn không phải hợp đồng hỗ trợ, và một câu trả lời năm năm tuổi về phiên bản giao thức bạn không chạy cũng vậy.

Che thông tin bí mật mà không làm phẳng cấu trúc mạng

Hãy xóa khóa riêng, mật khẩu, mã thông báo và liên kết mang thông tin đăng nhập trước khi bất cứ thứ gì rời máy bạn. Bản xuất chẩn đoán và cấu hình đầy đủ là hai tạo tác khác nhau dù tên tệp trông giống nhau, và phần bạn dán có thể chứa khóa đã chia sẻ trước.

Sau đó giữ những quan hệ khiến luồng dễ hiểu. RFC 6973 coi việc thu thập và tương quan không cần thiết là vấn đề riêng tư, và nguyên tắc đó cũng áp dụng ở đây: chia sẻ bằng chứng người nhận cần, không phải toàn bộ máy.

Kết thúc bằng một câu hỏi có thể trả lời về sự không khớp đã quan sát, ví dụ vì sao ứng dụng khách hoàn tất xác thực rồi không bao giờ nhận được tuyến. Câu hỏi cụ thể nhận câu trả lời cụ thể, và bản ghi bạn dựng nên chính là thứ cho phép ai đó trả lời mà không hỏi bí mật của bạn.