# ds-harness-remote: điều khiển DeepSeek Harness từ xa qua P2P mã hoá — hướng dẫn cài đặt và dùng

> ds-harness-remote là plugin cho DeepSeek Harness (DSH), cho phép bạn truy cập từ xa các workspace và phiên làm việc đang chạy trên máy của mình bằng điện thoại, máy tính khác hoặc trình duyệt. Dữ liệu đi qua kênh mã hoá đầu cuối, máy chủ không cần mở cổng công khai. Cài đặt khá dễ nếu bạn đã dùng DeepSeek Harness Desktop: chỉ cần thêm plugin từ npm rồi khởi động lại.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-08-17 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/ds-harness-remote-dieu-khien-deepseek-harness-tu-xa-2

ds-harness-remote là một plugin cho DeepSeek Harness (gọi tắt là DSH), giúp bạn truy cập từ xa vào chính cái Harness đang chạy trên máy làm việc của mình. Bạn có thể dùng điện thoại, một máy tính khác hoặc trình duyệt web để mở lại đúng phiên làm việc đó, với cùng workspace, cùng công cụ, cùng cấu hình dự án.

Vấn đề nó giải quyết rất đời thường: bạn giao cho AI một việc dài trên máy ở văn phòng, rồi phải đi ra ngoài. Thay vì ngồi canh máy, bạn mở điện thoại lên xem tiến độ, nhắn thêm yêu cầu, duyệt các bước cần xác nhận. Repo này hợp với lập trình viên, người làm việc nhiều với AI agent trên một máy cố định, và người muốn làm việc từ nhiều thiết bị mà không phải dựng VPN hay mở cổng router.

Điểm đáng giá nhất: máy chủ (gọi là Host) chỉ kết nối ra ngoài, không cần IP công khai, không cần chuyển tiếp cổng. Nội dung hội thoại được mã hoá đầu cuối, dịch vụ trung gian chỉ chuyển ciphertext. Hiện repo có khoảng 2769 sao và 207 fork, giấy phép MIT, viết bằng TypeScript.

```repo
- repo | liguobao/ds-harness-remote
- kind | Plugin
- desc | Plugin cho DeepSeek Harness: mở lại phiên làm việc trên máy bạn từ điện thoại, máy tính khác hoặc trình duyệt qua kênh P2P mã hoá đầu cuối.
- stars | 2.8k
- lang | TypeScript
- license | MIT
```

## ds-harness-remote làm được gì

**Truy cập Harness trên máy bạn từ nhiều nơi.** Bạn dùng web, máy tính khác hoặc điện thoại để vào Harness đang chạy ở máy chính. Ưu tiên là DSH, ngoài ra còn hỗ trợ Codex, Cursor và Antigravity.

**Giữ nguyên giao diện gốc của Harness.** Máy khách chuyển sang dùng API gốc của Host đã chọn, nên workspace, công cụ và luồng xin phép vẫn nằm ở máy chính. Bạn không phải học một giao diện mới.

**Không cần mở cổng hay IP công khai.** Host chỉ mở kết nối đi ra. Đường kết nối được thử theo thứ tự LAN, rồi P2P, rồi TURN, cuối cùng là Relay qua WebSocket mã hoá. Nghĩa là mạng phức tạp vẫn có cơ hội nối được.

**Làm việc với file và terminal từ xa.** Qua thanh bên của Harness, bạn duyệt file workspace, xem trước ở chế độ chỉ đọc, dùng terminal từ xa và xem trước các dịch vụ phát triển cục bộ đã được cấp phép.

**Điều khiển nhiều agent khác qua ACP (thử nghiệm).** Ngoài DeepSeek Harness, Host có thể chạy các agent hỗ trợ ACP như Codex, Cursor, Antigravity, Pi, OpenCode, Claude (qua `claude-agent-acp` đã ủy quyền cục bộ) và Hermes. Mỗi agent giữ workspace và phiên riêng của nó.

**Nhiều thiết bị cùng lúc.** Nhiều máy khách có thể kết nối vào một Host, mỗi kết nối được tách riêng.

**Có sẵn các máy khách.** Gồm plugin cho DSH Desktop, trang Web, app Android (APK), DSH Go (app Android của một tác giả khác), iOS đang thử nghiệm qua TestFlight, và Linux trên máy chủ đám mây.

## Cần chuẩn bị gì

Theo README, bạn cần:

- **DeepSeek Harness Desktop** đã cài. Đây là cách cài chính được mô tả. Mốc phiên bản hiện tại là `dsh-v0.2.2-rc.1`; các bản `dsh-v0.2.1-rc.5` và `0.2.0` rc.2 / rc.1 vẫn tương thích.
- **Tài khoản đăng nhập**: Zhihu, GitHub, Google, hoặc tài khoản và mật khẩu. Đăng ký tài khoản cần mã mời, README bảo bạn email cho tác giả repo để xin.
- **Kết nối Internet** ở cả Host và máy khách.
- Host có thể chạy Windows, macOS, Linux, hoặc cả DSH Go.
- Nếu muốn dùng agent khác (Cursor, Claude, Hermes…), bạn cần tự cài và cấu hình các công cụ đó trên Host trước. README chưa nêu chi tiết từng phiên bản yêu cầu ở phần này, bạn xem thêm hướng dẫn tích hợp agent trong thư mục `docs/`.

README không nói gì về yêu cầu GPU hay cấu hình phần cứng riêng cho plugin.

```note
Mặc định plugin dùng máy chủ do dự án cung cấp (https://dsh.r2049.cn). Nếu bạn muốn tự dựng, repo có bản Server tối giản, nhưng không có đầy đủ trải nghiệm Remote Web, và TURN cần bạn tự triển khai coturn.
```

## Cài đặt từng bước

```steps
- Cài plugin | Thêm ds-harness-remote@0.6.5 trong mục Extensions / Plugin management của DSH Desktop
- Khởi động lại | Tắt và mở lại DSH Desktop
- Đăng nhập | Mở mục Remote ở thanh bên và đăng nhập
- Cài trên thiết bị thứ hai | Cài cùng plugin, hoặc dùng Web / Android / iOS / DSH Go
- Chọn Host | Chọn máy đang online và mở workspace
```

### Cài plugin trong DSH Desktop

Mở DeepSeek Harness Desktop, vào **Extensions / Plugin management**, chọn cài từ npm, rồi nhập đúng tên gói:

```text
ds-harness-remote@0.6.5
```

Sau đó khởi động lại Desktop. Nếu bạn quen dòng lệnh, launcher `dsh` chính thức cũng cài được đúng gói này:

```bash
dsh plugin --profile desktop add -w ds-harness-remote@0.6.5
```

Lệnh này chạy trong terminal (PowerShell hoặc Terminal) trên máy đã cài DSH. Người mới hay vấp ở chỗ gõ sai tên gói hoặc quên khởi động lại, nên hãy chép nguyên văn.

Với DSH 0.2.2 trở lên, bản cài từ npm có thể kiểm tra phiên bản và cập nhật ngay trong Plugin management. Nếu bạn cài bằng GitHub hoặc liên kết cục bộ thì phải chuyển sang npm trước khi dùng cập nhật trực tuyến.

### Đăng nhập trong mục Remote

Trên thanh bên của DeepSeek Harness, mở **Remote**. 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. Nhớ rằng đăng ký tài khoản mới cần mã mời.

### Kết nối từ thiết bị thứ hai

Bạn có ba hướng:

- Cài cùng plugin trên một DSH khác, rồi đăng nhập cùng tài khoản.
- Mở trang Web tại https://dsh.r2049.cn, không cần cài plugin.
- Dùng app Android: tải APK ở trang Releases của repo, đăng nhập cùng tài khoản để thấy danh sách Host của bạn. iOS hiện chỉ là bản beta qua TestFlight, chưa phát hành công khai (xem issue số 20 trong repo).

Nếu cần lấy mã nguồn về xem, bạn có thể clone repo:

```bash
git clone https://github.com/liguobao/ds-harness-remote.git
cd ds-harness-remote
```

Bước này không bắt buộc để dùng plugin. Người dùng thường chỉ cần cài từ npm như trên.

### Chọn Host và mở workspace

Trên thiết bị thứ hai, chọn một Host đang online, rồi chọn workspace có sẵn hoặc duyệt thư mục từ xa để mở. Workspace sẽ hiện trong giao diện Harness gốc, kèm thông tin Host đang dùng và trạng thái kết nối mã hoá ở phần đầu.

### Cài trên máy chủ Linux

Nếu Host là máy chủ Linux đám mây, README hướng dẫn: vào https://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 không in sẵn lệnh đó, bạn lấy lệnh trực tiếp trên trang web sau khi đăng nhập.

```note
Trình cài đặt Linux cấu hình một dịch vụ systemd cấp hệ thống, nên Host, công cụ của agent và terminal từ xa chạy với quyền root. Chỉ cho các tài khoản bạn tin tưởng truy cập.
```

## Kiểm tra đã chạy được chưa

README không đưa ra một lệnh kiểm tra riêng. Các dấu hiệu thành công theo mô tả là:

- Sau khi khởi động lại, thanh bên của DeepSeek Harness có mục **Remote**.
- Đăng nhập xong, trên thiết bị khác bạn thấy Host của mình ở trạng thái online trong danh sách.
- Mở workspace từ xa, giao diện Harness gốc hiện ra, phần đầu có tên Host đang dùng và trạng thái kênh mã hoá.

Bạn cũng có thể vào danh sách Host ở trang https://dsh.r2049.cn để xem máy nào đang online.

Một mẹo: nếu không muốn máy này điều khiển các máy khác trong tài khoản, bật tuỳ chọn **Controlled only** ở danh sách Host. Máy đó sẽ không thấy thiết bị khác nữa, nhưng Web và các máy khách khác vẫn kết nối vào nó được.

## Dùng vào việc thật

Những tình huống dưới đây bám đúng khả năng mô tả trong README: xem và gửi yêu cầu từ xa, duyệt file, dùng terminal, điều khiển nhiều agent.

### Lập trình viên theo dõi tác vụ dài khi đi ăn trưa

Bạn giao cho DSH một việc dài trên máy ở công ty, ví dụ đọc cả dự án và sửa một nhóm lỗi. Trước khi rời bàn, bạn đã đăng nhập plugin. Ra ngoài, mở app Android, đăng nhập cùng tài khoản, chọn Host đang online, mở đúng workspace. Bạn thấy tiến độ, đọc lịch sử, và có thể nhắn thêm yêu cầu bằng văn bản hoặc ảnh. Kết quả: không phải về chỗ ngồi chỉ để bấm duyệt một bước.

> Máy vẫn chạy ở nhà, bạn chỉ mở thêm một ô cửa để nhìn vào.
>
> — Ông T

### Người làm việc hai máy: laptop và máy bàn

Bạn có máy bàn mạnh ở nhà, còn đi cà phê chỉ mang laptop. Cài plugin ở cả hai máy, đăng nhập cùng tài khoản. Trên laptop, mở Remote, chọn máy bàn làm Host, rồi mở workspace của nó. Giao diện là Harness gốc nên thao tác như làm tại chỗ. Muốn xem file thì duyệt qua thanh bên ở chế độ xem trước chỉ đọc; muốn chạy lệnh thì dùng terminal từ xa (chạy với quyền của người dùng Host).

### Dùng thử Codex, Cursor hoặc Claude Code từ điện thoại

Nếu máy bạn đã cài và cấu hình sẵn Cursor hoặc Codex, Host có thể chuyển prompt, câu trả lời dạng stream và các yêu cầu xin phép qua ds-harness-remote. Với Claude, bạn bật trong phần cài đặt và cần `claude-agent-acp` đã uỷ quyền cục bộ; hiện hỗ trợ văn bản và xác nhận, chưa hỗ trợ ảnh. Đây là tính năng thử nghiệm, nên hãy thử với dự án không quan trọng trước.

### Tự lập một máy chủ Linux làm Host

Bạn muốn một Host chạy liên tục mà không phụ thuộc máy cá nhân. Vào trang chính thức, đăng nhập, lấy mã uỷ quyền và cài bằng một lệnh. Sau đó dùng Web hoặc app để vào từ bất cứ đâu. Nhớ lưu ý về quyền root ở trên, nên chỉ dùng cho môi trường bạn kiểm soát.

## 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 có thể thay vào đó đăng nhập bằng Zhihu, GitHub hoặc Google, hoặc liên hệ tác giả repo để xin mã mời.

**Không thấy mục Remote sau khi cài.** Thường là chưa khởi động lại DSH Desktop. Đóng hẳn rồi mở lại. Kiểm tra tên gói đã nhập đúng `ds-harness-remote@0.6.5` và bạn đang cài từ npm.

**Không thấy Host nào online.** Host phải đang chạy DeepSeek Harness có cài plugin và đã đăng nhập cùng tài khoản. Kiểm tra máy chính có đang mở và có Internet không. Cũng kiểm tra xem bạn có vô tình bật **Controlled only** hay không, vì tuỳ chọn đó chỉ thay đổi việc máy này nhìn thấy máy khác.

**Host bị từ chối vì phiên bản.** README nói bản Harness 0.1.1-rc.2 dùng ApiProxy đã bị bỏ hỗ trợ. Host chỉ có ApiProxy hoặc thiếu khả năng dò tính năng sẽ bị từ chối, không có phương án dự phòng. Hãy nâng DeepSeek Harness lên bản tương thích (mốc hiện tại `dsh-v0.2.2-rc.1`) và xem hướng dẫn tương thích trong `docs/`.

**Kết nối chập chờn hoặc chậm.** Plugin thử LAN, P2P, TURN rồi mới đến Relay. Nếu mạng chặn WebRTC, nó sẽ rơi về Relay WebSocket mã hoá nên có thể chậm hơn. Nếu bạn tự dựng máy chủ, nhớ TURN cần coturn do bạn tự triển khai.

**Cập nhật plugin thất bại.** Với DSH 0.2.2 trở lên, hệ thống cố khôi phục bản trước nếu cập nhật nóng lỗi. Nếu bạn cài bằng GitHub hoặc liên kết cục bộ thì chuyển sang cài từ npm trước.

## Có nên dùng không

**Điểm mạnh.** Không cần IP công khai hay chuyển tiếp cổng. Giao diện là Harness gốc nên không phải học lại. Mã hoá đầu cuối với bộ `Noise_IK_25519_ChaChaPoly_SHA256`, kết nối phải qua kiểm tra cùng tài khoản và khoá định danh thiết bị đã ghim cục bộ. Dịch vụ không đọc được nội dung hội thoại, đường dẫn workspace hay nội dung file. Xem trước file là chỉ đọc, không ghi, xoá hay tải lên. Có nhiều máy khách, giấy phép MIT, và repo còn được cập nhật trong vài tháng gần đây.

**Giới hạn.** Bạn phải dùng DeepSeek Harness; đây không phải công cụ điều khiển máy tính nói chung. Máy chủ dùng chung của dự án cần tài khoản, và đăng ký cần mã mời. iOS còn là bản beta. Client terminal dsh-TUI mới ở mức dự kiến. Các tích hợp ACP đều ghi là thử nghiệm, một số chưa hỗ trợ ảnh. Terminal từ xa chạy với quyền của người dùng Host và không phụ thuộc vào phê duyệt của agent, nên hãy cân nhắc kỹ trước khi mở cho thiết bị khác. Tài liệu gốc chủ yếu bằng tiếng Trung và tiếng Anh, chưa có bản tiếng Việt.

**Khi nào chọn cách khác.** Nếu bạn cần điều khiển toàn bộ màn hình máy tính, remote desktop phù hợp hơn, vì repo này chỉ truyền các thông điệp cần cho giao diện hội thoại Harness và không mở điều khiển desktop. Nếu bạn muốn mạng riêng cho nhiều dịch vụ khác nhau, README cũng nhắc Tailscale, CF Turn hay UU Remote là những giải pháp tốt, tuỳ nhu cầu mà chọn. Còn nếu bạn đã dùng DeepSeek Harness hằng ngày và muốn mang nó theo người, đây là lựa chọn đáng thử.

## Câu hỏi thường gặp

### ds-harness-remote có miễn phí không?

Repo dùng giấy phép MIT. Mặc định plugin dùng máy chủ do dự án cung cấp tại dsh.r2049.cn, nhưng README không nói gì về phí hay giới hạn sử dụng của máy chủ này. Bạn cũng có thể tự dựng máy chủ tối giản trong repo.

### Có cần IP công khai hoặc mở cổng router không?

Không. Máy Host chỉ mở kết nối đi ra và không lắng nghe cổng công khai. Kết nối được thử theo thứ tự LAN, P2P, TURN rồi Relay qua WebSocket mã hoá.

### Dữ liệu và hội thoại của tôi có an toàn không?

Theo README, nội dung đi qua kênh mã hoá đầu cuối, dịch vụ chỉ chuyển ciphertext và không đọc được prompt, kết quả công cụ, đường dẫn workspace hay nội dung file. Dịch vụ vẫn thấy một số siêu dữ liệu điều khiển như tài khoản, sở hữu thiết bị, trạng thái online và thời điểm kết nối.

### Chạy được trên Windows không? Host cần hệ điều hành nào?

Được. README nói bất kỳ Harness nào đã cài plugin và đăng nhập đều làm Host được, trên Windows, macOS, Linux hoặc cả DSH Go. Trình cài một lệnh cho Linux dành cho máy chủ đám mây.

### Có dùng được trên điện thoại không?

Có. Android có app riêng, tải APK ở trang Releases của repo, ngoài ra có DSH Go. iOS hiện là bản beta qua TestFlight, chưa phát hành công khai. Bạn cũng có thể dùng trang Web trên trình duyệt điện thoại.

### Khác gì frp, tunnel hay remote desktop?

README cho biết dự án thử bốn chế độ kết nối để thiết lập P2P, không bắt mọi lưu lượng đi qua máy chủ. Khác với remote desktop, nó chỉ truyền các thông điệp cần cho giao diện hội thoại Harness, không chiếu cả màn hình và không mở điều khiển desktop. Tailscale hay UU Remote được README nhắc là những lựa chọn tốt khác.

### Có cần GPU hoặc cấu hình mạnh không?

README không nêu yêu cầu GPU hay cấu hình phần cứng riêng cho plugin. Chưa có thông tin chi tiết hơn trong tư liệu đã đọc.
