Hướng dẫn cấu hình dịch vụ proxy ngược Pinggy trong ServBay

Pinggy là một công cụ xuyên tường lửa nhẹ và dễ sử dụng, giúp bạn nhanh chóng xuất bản an toàn dịch vụ Web chạy nội bộ ra Internet công cộng. ServBay tích hợp Pinggy, mang lại cho lập trình viên macOS một cách thuận tiện để tạo tunnel công khai, phù hợp cho việc trình diễn mã nguồn, kiểm thử API hoặc chia sẻ thành quả phát triển nội bộ với đồng nghiệp bên ngoài. Hướng dẫn này sẽ giúp bạn từng bước cấu hình và sử dụng Pinggy trong ServBay.

Tổng quan

ServBay tích hợp sẵn Pinggy, giúp việc cài đặt và quản lý trở nên vô cùng đơn giản. Bạn có thể điều khiển tunnel Pinggy trực tiếp trong giao diện đồ họa của ServBay, cho phép ánh xạ website nội bộ lên một URL công khai để truy cập từ Internet.

Ứng dụng thực tế

• Trình diễn nhanh: Gửi demo ngay lập tức website hoặc ứng dụng bạn đang phát triển trên macOS tới khách hàng hoặc đồng nghiệp.
• Kiểm thử API & Webhook: Cung cấp điểm cuối công khai tạm thời cho các dịch vụ bên thứ ba yêu cầu callback từ Internet (ví dụ: đăng nhập qua mạng xã hội, hàng đợi tin nhắn).
• Gỡ lỗi từ xa: Dễ dàng mở quyền truy cập và kiểm thử môi trường phát triển nội bộ cho đồng đội từ xa.
• Kiểm thử trên di động: Cho phép thiết bị di động truy cập dịch vụ backend nội bộ thông qua URL công khai.

Điều kiện cần thiết

1. Đã cài đặt ServBay: Đảm bảo hệ thống macOS của bạn đã cài đặt và đang chạy ServBay phiên bản mới nhất.
2. Tài khoản Pinggy: Bạn cần có một tài khoản Pinggy. Truy cập Trang chủ Pinggy để đăng ký (có cả gói miễn phí và trả phí).
3. Website nội bộ: Đã cấu hình và chạy ít nhất một website cục bộ trên ServBay, ví dụ như servbay.demo hoặc kirby.test.

Các bước thao tác

1. Cài đặt gói phần mềm Pinggy trong ServBay

Nếu đây là lần đầu sử dụng Pinggy trên ServBay, cần cài đặt gói phần mềm trước:

1. Mở ứng dụng ServBay.

2. Ở thanh điều hướng bên trái, chọn Phần mềm (Packages).

3. Trong danh sách phần mềm khả dụng, tìm hoặc nhập Pinggy.

4. Nhấn nút cài đặt bên cạnh Pinggy.

5. Sau khi cài đặt xong, có thể thử nhấn công tắc khởi động bên phải Pinggy. Nếu dịch vụ chưa chạy hoặc báo trạng thái lỗi lúc này là điều bình thường, do Pinggy chưa cấu hình. Các bước cấu hình sẽ thực hiện ngay sau đây.

   

2. Lấy Pinggy Access token của bạn

Pinggy sử dụng Access token để xác thực tài khoản và kích hoạt dịch vụ tunnel.

1. Truy cập Pinggy Dashboard và đăng nhập bằng tài khoản của bạn.

2. Sau đăng nhập, bạn sẽ thấy Access token cá nhân tại mục "Access token" ngay trên trang chính của Dashboard.

3. Sao chép Access token này. Nó là một chuỗi ký tự, hãy giữ gìn cẩn thận.

   

3. Cấu hình Pinggy trong ServBay

Sau khi có Access token, quay lại ứng dụng ServBay để cấu hình:

1. Trong thanh điều hướng bên trái của ServBay, chọn Tunnel.

2. Ở danh sách dịch vụ Tunnel, nhấn Pinggy.

   

3. Auth Token (Mã xác thực):

   • Dán chính xác Access token vừa sao chép từ Dashboard Pinggy vào trường Auth Token.

4. Cấu hình tunnel (Local Domain và External Domain): ServBay hỗ trợ tạo nhiều tunnel Pinggy cho các website nội bộ khác nhau.

   • Local Domain (Website cục bộ):
     • Nhấn menu xổ xuống và chọn website nội bộ bạn muốn chia sẻ công khai qua Pinggy, ví dụ thinkphp.test hoặc servbay.demo.
   • External Domain (Tên miền ngoài):
     • Đối với người dùng Pinggy miễn phí: Hãy để trống trường này. Pinggy sẽ tự động tạo URL công khai ngẫu nhiên cho tunnel của bạn (thường có đuôi .a.free.pinggy.link hoặc .pinggy.link). Khi tunnel được tạo thành công, ServBay sẽ lấy và hiển thị URL này tại đây.
     • Đối với người dùng trả phí: Nếu tài khoản Pinggy hỗ trợ tên miền tùy chọn hoặc đã giữ tên miền, bạn có thể nhập tên miền ngoài muốn sử dụng vào đây.

5. Thêm nhiều tunnel hơn:

   • Để tạo thêm tunnel cho website khác, nhấn dấu + bên phải dòng tunnel hiện tại rồi lặp lại bước 4 để cấu hình tunnel mới.

6. Lưu cấu hình:

   • Sau khi cấu hình xong các tunnel, nhấn nút Save (Lưu lại) ở góc dưới bên phải giao diện.

4. Khởi động và kiểm tra dịch vụ Pinggy

1. Sau khi lưu cấu hình, ServBay sẽ tự khởi chạy Pinggy theo thiết lập mới của bạn.
2. Quan sát đèn trạng thái bên cạnh dòng Pinggy ở danh sách Tunnel. Nếu cấu hình đúng và Pinggy kết nối thành công tới server, đèn sẽ chuyển sang màu xanh lá (dịch vụ đang chạy).
3. Với mỗi tunnel được khởi tạo thành công, trường External Domain (nếu bỏ trống trước đó) sẽ hiển thị URL công khai do Pinggy cấp, ví dụ: https://random-string.a.free.pinggy.link.
4. Kiểm tra truy cập:
   • Nhấn vào biểu tượng sao chép bên cạnh tên miền ngoài để copy URL công khai.
   • Hoặc, nhấn biểu tượng trình duyệt (hình la bàn hoặc quả địa cầu) để mở nhanh URL này trên trình duyệt mặc định của bạn.
   • Nếu cài đặt đúng, bạn sẽ truy cập được website nội bộ qua URL Pinggy này.

5. Quản lý tunnel Pinggy

Ở giao diện cấu hình Pinggy của ServBay, bạn có thể dễ dàng quản trị các tunnel:

• Sao chép tên miền ngoài: Nhấn biểu tượng sao chép để lấy nhanh URL công khai chia sẻ cho người khác.
• Mở nhanh trên trình duyệt: Nhấn biểu tượng trình duyệt để tải thử nghiệm.
• Thêm tunnel: Nhấn dấu + để tạo tunnel mới.
• Xóa tunnel: Nhấn dấu - để gỡ bỏ tunnel không còn dùng nữa.
• Dừng/khởi động dịch vụ: Gạt công tắc bên cạnh dòng dịch vụ Pinggy để bật hoặc tắt toàn bộ dịch vụ tunnel.

Lưu ý quan trọng

• Tính năng bản miễn phí Pinggy: Tên miền ngoài của gói miễn phí là động, sẽ thay đổi mỗi khi khởi động lại Pinggy hoặc tunnel. Đồng thời, bản miễn phí cũng giới hạn số lượng kết nối đồng thời, băng thông, thời lượng sử dụng. Nếu muốn dùng tên miền cố định, hiệu suất cao hay tính năng nâng cao, hãy nâng cấp lên gói trả phí của Pinggy.
• Phụ thuộc dịch vụ nội bộ: Đảm bảo website bạn chọn ở trường Local Domain đã được cấu hình và chạy đúng trên ServBay (ví dụ đúng phiên bản PHP, đã khởi động Caddy/Nginx, cấu hình không lỗi). Pinggy chỉ truyền tiếp lưu lượng mạng, không xử lý dịch vụ cục bộ.
• Tường lửa & mạng: Đảm bảo firewall trên macOS hoặc phần mềm bảo mật bên thứ ba không chặn kết nối mạng của ServBay hoặc Pinggy client.
• Bảo mật HTTPS: Pinggy thường cung cấp HTTPS cho tunnel được tạo, đảm bảo mã hóa dữ liệu truyền tải — yếu tố bảo mật cần thiết với ứng dụng web hiện đại.

Câu hỏi thường gặp (FAQ)

• Q: Pinggy không khởi động thành công, đèn trạng thái không xanh, phải làm sao?
  • A: Trước tiên, kiểm tra kỹ Access token Pinggy nhập đã đúng chưa. Tiếp đến, xác minh kết nối Internet vẫn ổn định. Xem log Pinggy (biểu tượng log bên phải dịch vụ) để tra cụ thể thông báo lỗi.
• Q: Tôi dùng bản miễn phí Pinggy, sao trường External Domain lại bắt để trống?
  • A: Đây là cơ chế chuẩn của Pinggy miễn phí. Bạn không cần nhập tên miền ngoài thủ công. Khi tunnel kết nối thành công, ServBay sẽ tự động lấy URL công khai tạm thời từ server Pinggy và hiển thị vào trường này.
• Q: Pinggy khác gì Ngrok và các dịch vụ tunnel khác? Tôi nên chọn cái nào?
  • A: Pinggy và Ngrok đều là công cụ xuyên tường lửa nổi bật, nhưng khác biệt về tính năng, giới hạn bản miễn phí, giá gói trả phí, độ phức tạp khi cấu hình và vị trí server. Pinggy được đánh giá cao về tính nhẹ nhàng, dùng đơn giản. Bạn hãy lựa chọn dựa trên nhu cầu cụ thể (hỗ trợ giao thức, tên miền riêng, tài chính) và sở thích cá nhân. ServBay hỗ trợ nhiều dịch vụ loại này, cho bạn sự linh hoạt.

Tổng kết

Tính năng Pinggy tích hợp trong ServBay mang đến giải pháp cực kỳ tiện lợi cho lập trình viên web dùng macOS khi cần chia sẻ website nội bộ. Chỉ với vài thao tác cấu hình, bạn có thể xuất bản môi trường phát triển cục bộ một cách an toàn ra Internet, hỗ trợ hiệu quả cho trình diễn, kiểm thử và hợp tác. Hãy đảm bảo cấu hình phù hợp loại tài khoản Pinggy bạn dùng và website nội bộ luôn chạy ổn định để tận dụng tối đa tiện ích mà Pinggy mang lại.