ds-harness-remote: điều khiển DeepSeek Harness từ xa qua điện thoại, web — hướng dẫn cài và dùng
Bài này là một góc nhìn khác về liguobao/ds-harness-remote — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: ds-harness-remote: điều khiển DeepSeek Harness từ xa bằng điện thoại, web — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
ds-harness-remote là plugin cho DeepSeek Harness (DSH). Nó giúp bạn truy cập từ xa vào chính máy đang chạy Harness, từ điện thoại, máy tính khác hoặc trình duyệt, qua kênh mã hoá đầu cuối. Cài plugin bằng một dòng tên gói npm trong màn hình quản lý tiện ích nên không khó, nhưng bạn cần có DeepSeek Harness Desktop trước.
ds-harness-remote là một plugin cho DeepSeek Harness (gọi tắt là DSH), giúp bạn mở lại đúng phiên làm việc đang chạy trên máy ở văn phòng từ điện thoại, một máy tính khác hoặc trình duyệt web. Harness vẫn chạy trên máy gốc, với đúng workspace, công cụ và cấu hình cũ. Plugin này chỉ là thêm một ô cửa khác để nhìn vào môi trường đó.
Nếu bạn hay rời bàn làm việc mà vẫn muốn theo dõi một tác vụ AI đang chạy, hoặc muốn nhắn thêm yêu cầu từ điện thoại, thì repo này dành cho bạn. Nó cũng hợp với lập trình viên có máy mạnh ở nhà hoặc một server Linux trên cloud, và muốn điều khiển chúng từ bất cứ đâu.
Điểm đáng giá nhất: máy chạy Harness không cần IP công cộng và không phải mở cổng router. Nó chỉ kết nối ra ngoài, còn dữ liệu hội thoại được mã hoá đầu cuối. Repo hiện có khoảng 2724 sao và 202 fork, dùng giấy phép MIT.
liguobao/ds-harness-remote
Plugin cho DeepSeek Harness, cho phép dùng lại phiên làm việc trên máy của bạn từ điện thoại, máy tính khác hoặc trình duyệt qua kênh mã hoá đầu cuối.
I.ds-harness-remote làm được gì
- Truy cập từ web, máy tính hoặc điện thoại. Bạn mở được Harness trên máy gốc từ trình duyệt, từ một máy khác có cài DSH, hoặc từ app Android. Ưu tiên là DSH, ngoài ra còn hỗ trợ Codex, Cursor và Antigravity.
- Dùng giao diện Harness gốc. Khi mở một Host từ xa, bạn thấy giao diện Harness quen thuộc. Bạn vẫn tạo workspace, cấu hình model và đổi model hội thoại như khi dùng tại chỗ.
- Không cần mở cổng. Máy Host chỉ kết nối ra ngoài. Plugin thử lần lượt các đường LAN, P2P, TURN rồi cuối cùng là Relay qua WebSocket mã hoá. Nhờ vậy bạn vẫn kết nối được khi mạng có NAT phức tạp.
- Mã hoá đầu cuối. Nội dung hội thoại, prompt, kết quả công cụ, đường dẫn workspace và nội dung file xem thử được mã hoá ở máy client và chỉ Host mới giải mã được. Máy chủ trung gian chỉ chuyển dữ liệu đã mã hoá.
- Xem file, terminal từ xa. Qua thanh bên của Harness, bạn duyệt file workspace (chỉ xem, không ghi hay xoá), mở terminal từ xa và xem trước dịch vụ phát triển cục bộ đã được cấp quyền.
- Nhiều thiết bị cùng lúc. README ghi hiện chưa giới hạn số client kết nối vào một Host, mỗi kết nối được tách riêng.
- Làm việc với agent khác qua ACP. Plugin còn kết nối được Codex, Cursor, Antigravity, Pi, OpenCode, Claude Code và Hermes. Phần này README ghi là thử nghiệm, và mỗi agent có điều kiện riêng.
II.Cần chuẩn bị gì
Tư liệu của repo nói những điều sau:
- DeepSeek Harness Desktop trên máy sẽ làm Host. Mốc phiên bản hiện tại là
dsh-v0.2.2-rc.1. Các bảndsh-v0.2.1-rc.5và0.2.0rc.2 / rc.1 vẫn tương thích. - Hệ điều hành của Host: Windows, macOS, Linux đều làm Host được. DSH Go trên điện thoại cũng làm Host được.
- Tài khoản đăng nhập. Remote dùng sẵn máy chủ do dự án cung cấp. Bạn đăng nhập bằng Zhihu, GitHub hoặc Google, hoặc bằng tài khoản và mật khẩu. Đăng ký tài khoản kiểu này cần mã mời, bạn phải email cho tác giả repo để xin.
- Kết nối internet ở cả máy Host lẫn thiết bị bạn dùng để truy cập.
- Nếu muốn dùng agent ngoài (Codex, Cursor, Claude Code…), bạn phải cài sẵn và cấu hình agent đó trên Host. README không ghi chi tiết yêu cầu phần cứng, và chưa nói về chi phí của dịch vụ.
III.Cài đặt từng bước
- Cài pluginTrong DeepSeek Harness Desktop, vào Extensions / Plugin management và cài từ npm
- Khởi động lạiTắt rồi mở lại Desktop để plugin nạp
- Đăng nhậpMở mục Remote ở thanh bên và đăng nhập
- Cài ở thiết bị thứ haiDùng web, app Android hoặc cài cùng plugin trên máy khác, đăng nhập cùng tài khoản
- Chọn HostChọn máy đang online và mở workspace
A.Cài plugin trong DeepSeek Harness Desktop
Trên máy sẽ làm Host, mở DeepSeek Harness Desktop. Vào Extensions / Plugin management, chọn cài đặt từ npm và nhập tên gói sau:
ds-harness-remote@0.6.4Sau đó khởi động lại Desktop. Phần lớn người mới vấp ở đây: bạn gõ tên gói vào ô cài đặt của Desktop, không phải vào terminal.
Nếu thích dùng dòng lệnh, README nói launcher dsh chính thức cũng cài được đúng phiên bản này:
dsh plugin --profile desktop add -w ds-harness-remote@0.6.4Với DSH bản 0.2.2 trở lên, nếu bạn cài từ npm thì có thể kiểm tra phiên bản và cập nhật ngay trong Plugin management. Nếu bạn cài từ GitHub hoặc liên kết cục bộ, README bảo phải chuyển sang cài từ npm trước.
B.Đăng nhập trong mục Remote
Mở Remote ở thanh bên của DeepSeek Harness. Chọn đăng nhập bằng Zhihu, GitHub hoặc Google, hoặc dùng tài khoản và mật khẩu. Mặc định plugin dùng máy chủ của dự án tại dsh.r2049.cn.
C.Kết nối từ thiết bị thứ hai
Bạn có ba lựa chọn:
- Mở trang web dsh.r2049.cn trong trình duyệt và đăng nhập cùng tài khoản.
- Tải file APK của app Android ở trang Releases của repo, rồi đăng nhập cùng tài khoản để thấy các Host.
- Cài cùng plugin trong DeepSeek Harness trên máy tính khác và đăng nhập như trên.
App iOS hiện mới ở dạng bản thử qua TestFlight, chưa phát hành công khai. README chỉ tới issue số 20 của repo để đăng ký.
D.Chọn Host và mở workspace
Trên thiết bị thứ hai, chọn một Host đang online. Rồi bạn chọn workspace có sẵn, hoặc duyệt thư mục trên máy Host để mở một workspace mới. Trình chọn workspace chỉ liệt kê thư mục và trả về thông tin chỉ-đọc.
E.Cài một lệnh trên server Linux
README mô tả cách này: vào trang dsh.r2049.cn, đăng nhập, lấy mã uỷ quyền cài đặt, rồi cài bằng một lệnh. README tóm tắt không chép lệnh cụ thể, nên bạn hãy lấy lệnh đúng trên chính trang đó.
Trình cài đặt Linux tạo một dịch vụ systemd cấp hệ thống, nên Host, công cụ của agent và terminal từ xa đều chạy với quyền root. Chỉ cho các tài khoản bạn tin tưởng truy cập vào Host này.
IV.Kiểm tra đã chạy được chưa
Theo README, bạn thành công khi thấy các dấu hiệu sau:
- Sau khi khởi động lại Desktop, mục Remote xuất hiện ở thanh bên của Harness.
- Trên thiết bị thứ hai, sau khi đăng nhập cùng tài khoản, danh sách Host hiện máy của bạn ở trạng thái online.
- Khi mở workspace từ xa, thanh tiêu đề hiện Host đang dùng và trạng thái kết nối mã hoá.
Nếu máy Host không xuất hiện trong danh sách, hãy xem phần lỗi hay gặp bên dưới.
V.Dùng vào việc thật
A.Theo dõi tác vụ AI khi đi ra ngoài
Bạn là nhân viên văn phòng, nhờ Harness tổng hợp một thư mục báo cáo ở máy công ty. Đến giờ đi họp, bạn không muốn ngồi chờ. Mở app Android, đăng nhập cùng tài khoản, chọn máy công ty rồi mở lại đúng phiên đó. Bạn xem kết quả đang chạy, và nhắn thêm yêu cầu bằng chữ hoặc ảnh.
Prompt mẫu: Tóm tắt thêm phần chi phí tháng này thành 5 gạch đầu dòng. Kết quả hiện ngay trong phiên trên máy gốc, và khi về bàn bạn thấy nguyên lịch sử ở đó.
Máy vẫn ở bàn làm việc, còn bạn thì không cần phải ở đó.
Ông T
B.Dùng máy nhà từ laptop mượn
Bạn là dev, máy mạnh ở nhà đang chứa dự án, còn bạn đang ngồi quán cà phê với một laptop khác. Mở trình duyệt vào dsh.r2049.cn, đăng nhập, chọn Host ở nhà và mở workspace dự án. Bạn dùng giao diện Harness gốc, xem file chỉ-đọc, mở terminal từ xa nếu cần.
Vì không cần mở cổng router nên bạn không phải chỉnh gì ở modem nhà. Điều kiện duy nhất là máy ở nhà đang bật và đang online.
C.Điều khiển một server Linux trên cloud
Bạn thuê một VPS để chạy các tác vụ dài. Đăng nhập trang dsh.r2049.cn, lấy mã uỷ quyền cài đặt, chạy lệnh cài một dòng trên server theo hướng dẫn ở đó. Server sẽ hiện như một Host trong danh sách. Từ điện thoại hay web, bạn mở workspace trên server và giao việc.
Hãy nhớ phần cảnh báo quyền root ở trên. Đừng dùng cách này cho server chứa dữ liệu nhạy cảm nếu bạn chưa chắc ai có quyền vào tài khoản.
D.Dùng Claude Code hoặc Codex qua cùng một cửa
Nếu bạn đã quen một agent khác, README nói plugin kết nối được qua ACP. Ví dụ Claude kết nối qua claude-agent-acp đã được cấp quyền cục bộ, và bạn phải bật trong phần cài đặt. Codex kết nối qua App Server, Cursor qua giao diện ACP của CLI.
Họ vẫn giữ workspace và phiên riêng của mình. Plugin chỉ chuyển tiếp prompt, kết quả stream và các yêu cầu duyệt. Phần này README ghi là thử nghiệm, nên hãy thử trên dự án không quan trọng trước. Với Claude, README ghi hiện hỗ trợ văn bản và duyệt quyền, chưa hỗ trợ ảnh.
VI.Lỗi hay gặp và cách xử lý
- Không đăng ký được tài khoản. Đăng ký bằng tài khoản và mật khẩu cần mã mời. Bạn hãy dùng đăng nhập Zhihu, GitHub hoặc Google, hoặc email cho tác giả repo để xin mã mời.
- Mục Remote không hiện sau khi cài. Bạn nhớ khởi động lại Desktop sau khi cài plugin. Kiểm tra thêm bản DSH đang dùng có nằm trong các bản tương thích ở phần chuẩn bị không.
- Thiết bị thứ hai không thấy máy Host. Hãy chắc chắn đăng nhập cùng một tài khoản ở cả hai nơi, và máy Host đang bật và có mạng. Cũng kiểm tra xem bạn có bật Controlled only ở danh sách Host trên web hay không. Tuỳ chọn này ẩn các thiết bị khác khỏi thiết bị đó, nhưng vẫn cho phép điều khiển nó từ xa.
- Báo Host không tương thích. README nói hỗ trợ ApiProxy của Harness
0.1.1-rc.2đã bị gỡ, và Host chỉ có ApiProxy hoặc không có khả năng dò tính năng sẽ bị từ chối, không có phương án dự phòng. Cách xử lý là nâng Harness lên bản được liệt kê tương thích. - Agent ngoài không xuất hiện. Claude và Hermes cần bật trong phần cài đặt. Pi cần cài và cấu hình cả
pi-acp. Hãy kiểm tra agent đó chạy được riêng trên Host trước khi dùng qua Remote.
VII.Có nên dùng không
Điểm mạnh: cài đơn giản, giữ nguyên giao diện và quyền của Harness trên máy gốc, không cần IP công cộng, có mã hoá đầu cuối, nhiều loại client (web, Android, DSH Go). Mã nguồn mở theo giấy phép MIT và repo còn được cập nhật trong 3 tháng gần đây.
Giới hạn:
- Mặc định bạn phụ thuộc vào máy chủ do dự án vận hành. Máy chủ tự dựng chỉ có bản tối giản, không có đầy đủ trải nghiệm Remote Web, và TURN phải tự dựng coturn.
- Đăng ký tài khoản kiểu mật khẩu cần mã mời.
- App iOS mới ở dạng beta. Client terminal dsh-TUI chỉ nằm trong kế hoạch.
- Hỗ trợ agent ngoài qua ACP vẫn ở mức thử nghiệm.
- Terminal từ xa chạy bằng quyền của người dùng trên Host, độc lập với bước duyệt của agent. Bạn nên cân nhắc kỹ trước khi cấp quyền.
Khi nào nên chọn cách khác: nếu bạn cần điều khiển cả màn hình máy tính, desktop từ xa hoặc Tailscale sẽ hợp hơn. README tự nói các giải pháp như Tailscale hay UU Remote cũng tốt, hãy chọn cái phù hợp với nhu cầu. Còn nếu bạn chỉ cần tiếp tục phiên Harness đang chạy ở máy khác với mức quyền hạn chế, thì ds-harness-remote đáng thử.
Câu hỏi thường gặp
ds-harness-remote có miễn phí không?
Mã nguồn dùng giấy phép MIT. Trong tư liệu mình có, README không nói gì về phí của máy chủ do dự án cung cấp, nên chưa có thông tin chắc chắn về chi phí dịch vụ. Bạn nên xem thêm ở trang dự án.
Máy chạy Harness có cần IP công cộng hay mở cổng router không?
Không. Máy Host chỉ kết nối ra ngoài, không lắng nghe trên cổng công cộng và không cần chuyển tiếp cổng. Plugin thử các đường LAN, P2P, TURN rồi mới đến Relay mã hoá.
Máy chủ của dự án có đọc được hội thoại của tôi không?
Theo README thì không. Nội dung hội thoại, prompt, kết quả công cụ, đường dẫn workspace và nội dung file xem thử đều được mã hoá đầu cuối. Dịch vụ vẫn thấy một số thông tin điều phối như tài khoản, thiết bị, trạng thái online và thời điểm kết nối.
Máy Windows có làm Host được không?
Có. README ghi bất kỳ Harness nào đã đăng nhập và cài plugin Remote đều làm Host được, trên Windows, macOS, Linux, hoặc cả DSH Go. Bạn chỉ cần cài DeepSeek Harness Desktop và plugin ds-harness-remote.
Có thể dùng trên iPhone không?
App iOS hiện đang là bản beta qua TestFlight, chưa phát hành công khai. Bạn có thể dùng trang web trên trình duyệt, hoặc app Android và DSH Go. README chỉ tới issue số 20 của repo để đăng ký tham gia beta.
Khác gì so với frp, tunnel hay remote desktop?
Theo README, chuyển tiếp cổng qua máy chủ có thể bị nghẽn băng thông. Remote desktop thì chiếu cả màn hình nên tốn băng thông và hiệu năng máy. Dự án này chỉ mã hoá và truyền các tin nhắn cần cho giao diện hội thoại Harness, còn quyền và bước duyệt vẫn ở Host.
Cài trên server Linux có an toàn không?
Trình cài đặt tạo dịch vụ systemd cấp hệ thống, nên Host, công cụ của agent và terminal từ xa chạy bằng quyền root. README khuyên chỉ cho các tài khoản đáng tin cậy truy cập. Bạn nên cân nhắc kỹ trước khi dùng với server có dữ liệu quan trọng.


