Cài đặt Native

Không cần Docker. Truy cập binary host như claude, git, gh, v.v.

Yêu cầu

Linux
macOS

sudo apt install ttyd tmux
# Hoặc: sudo snap install ttyd

brew install ttyd tmux go

Cài đặt

Cài đặt dependencies (xem ở trên)
Chạy lệnh deploy
Terminal window
```
./scripts/termote.sh install native
```
Truy cập tại http://localhost:7680

Khi nào sử dụng

Cần truy cập binary host (claude, git, gh, v.v.)
Không có Docker/Podman
Kiểm soát đầy đủ dịch vụ

Quản lý dịch vụ

# Kiểm tra processes
ps aux | grep ttyd
ps aux | grep tmux-api

# Khởi động lại
./scripts/termote.sh install native

Khắc phục sự cố

Chẩn đoán nhanh

./scripts/termote.sh health   # Kiểm tra sức khỏe
ss -tlnp | grep -E "7680|7681"  # Kiểm tra cổng

Kiểm tra tiến trình

ps aux | grep ttyd         # Kiểm tra ttyd đang chạy
ps aux | grep tmux-api     # Kiểm tra tmux-api đang chạy
lsof -i :7680              # Xác minh cổng chính
lsof -i :7681              # Xác minh cổng ttyd

Debug với logs

Chế độ native mặc định không ghi logs. Để xem logs:

# Dừng dịch vụ
./scripts/termote.sh uninstall native

# Chạy ttyd với logs (terminal 1)
ttyd -W -i lo -p 7681 tmux new-session -A -s main

# Chạy tmux-api với logs (terminal 2)
cd tmux-api
TERMOTE_PORT=7680 TERMOTE_BIND=127.0.0.1 \
TERMOTE_PWA_DIR=../pwa/dist ./tmux-api-native

Lỗi thường gặp

Lỗi	Giải pháp
Cổng đang dùng	`lsof -i :7680` rồi kill process
Thiếu ttyd	`brew install ttyd` (macOS) hoặc `apt install ttyd`
Thiếu binary	`cd tmux-api && go build -o tmux-api-native .`
PWA chưa build	`cd pwa && pnpm build`

tmux Session

tmux list-sessions         # Liệt kê sessions
tmux attach -t main        # Kết nối vào session
tmux kill-session -t main  # Reset session

Test API

curl http://localhost:7680/api/tmux/health
curl http://localhost:7680/api/tmux/sessions

Cập nhật

Qua One-liner

Chạy lại installer - sẽ so sánh version và hỏi trước khi cập nhật:

curl -fsSL https://raw.githubusercontent.com/lamngockhuong/termote/main/scripts/get.sh | bash

Tùy chọn:

--yes - Tự động cập nhật không hỏi
--download-only - Chỉ tải về, không cài đặt

Cập nhật thủ công

./scripts/termote.sh uninstall native
git pull origin main
./scripts/termote.sh install native

Gỡ cài đặt

./scripts/termote.sh uninstall native