Cài đặt Container

Container đơn với tmux-api (PWA + proxy) + ttyd + tmux.

Bắt đầu nhanh

1. Chạy lệnh deploy

   ./scripts/termote.sh install container

2. Truy cập tại http://localhost:7680

3. (Tùy chọn) Mở ra LAN

   ./scripts/termote.sh install container --lan

Docker Run

# Cơ bản (tự động tạo credentials, kiểm tra logs: docker logs termote)
docker run -d --name termote -p 7680:7680 ghcr.io/lamngockhuong/termote:latest

# Với credentials tùy chỉnh
docker run -d --name termote -p 7680:7680 \
  -e TERMOTE_USER=admin -e TERMOTE_PASS=secret \
  ghcr.io/lamngockhuong/termote:latest

# Không xác thực (chỉ dev local)
docker run -d --name termote -p 7680:7680 \
  -e NO_AUTH=true \
  ghcr.io/lamngockhuong/termote:latest

# Với lưu trữ
docker run -d --name termote -p 7680:7680 \
  -v termote-data:/home/termote \
  ghcr.io/lamngockhuong/termote:latest

Tùy chọn

Cờ	Mô tả
--lan	Mở ra LAN (mặc định: localhost)
--no-auth	Tắt xác thực cơ bản
--port <port>	Cổng tùy chỉnh (mặc định: 7680)

Mẹo

Script tự động phát hiện podman hoặc docker - cả hai hoạt động giống nhau.

Ghi chú

Sử dụng chế độ Container khi bạn không cần truy cập binary host (như claude hoặc git).

Khắc phục sự cố

Chẩn đoán nhanh

./scripts/termote.sh health   # Kiểm tra sức khỏe
docker ps -a | grep termote   # Kiểm tra trạng thái container

Xem logs

docker logs termote           # Xem logs
docker logs -f termote        # Theo dõi logs (live)

# Hoặc với podman:
podman logs termote

Container không khởi động

# Kiểm tra lỗi khởi động
docker logs termote

# Cổng đang dùng?
lsof -i :7680

# Dùng cổng khác
./scripts/termote.sh install container --port 7690

Debug trong container

docker exec -it termote /bin/sh
# Trong container:
ps aux                        # Kiểm tra tiến trình
curl localhost:7681           # Test ttyd
curl localhost:7680/api/tmux/health

Lỗi thường gặp

Lỗi	Giải pháp
Cổng đang dùng	lsof -i :7680 rồi kill hoặc dùng --port
Container crash	docker logs termote để xem lỗi
Auth không hoạt động	Restart container, kiểm tra logs để lấy password
Lỗi WebSocket	Kiểm tra ttyd đang chạy trong container

Khởi động lại / Reset

docker restart termote

# Reset hoàn toàn
./scripts/termote.sh uninstall container
./scripts/termote.sh install container

Test API

curl http://localhost:7680/api/tmux/health
curl -u admin:password 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 -s -- --container

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 container
git pull origin main
./scripts/termote.sh install container

Gỡ cài đặt

./scripts/termote.sh uninstall container