botAffilate/serverADB/deploy_armbian.md

Hướng dẫn đưa API lên Armbian (Sử dụng Wireless ADB)

Vì bạn sử dụng Wireless ADB, server Armbian và điện thoại phải kết nối cùng chung một mạng nội bộ (cùng kết nối vào một bộ định tuyến/WiFi).

Bước 1: Cài đặt công cụ trên Armbian

Mở Terminal (hoặc SSH) vào Armbian và chạy lệnh:

sudo apt update
# Cài đặt Python 3, pip và công cụ nền tảng ADB
sudo apt install python3 python3-pip adb -y

Bước 2: Bật và Kết nối ADB không dây

1. Trên điện thoại: Bật "Gỡ lỗi không dây" (Wireless Debugging) trong mục Tùy chọn nhà phát triển. Ghi lại IP và Port (ví dụ 192.168.1.55:5555).
2. Trên Armbian, kiểm tra kết nối mạng:

ping -c 3 192.168.1.55

3. Kết nối ADB từ Armbian tới điện thoại:

adb connect 192.168.1.55:5555

(Bạn có thể phải nhìn vào màn hình điện thoại để bấm "Cho phép" cho lần kết nối đầu tiên).

Bước 3: Triển khai Code

Copy toàn bộ thư mục botAffilate từ Windows sang Armbian (có thể dùng FileZilla, WinSCP). Di chuyển vào thư mục đó:

cd /path/to/botAffilate
pip3 install -r requirements.txt

Lưu ý: Đừng quên cập nhật biến DEVICE_IP trong file main.py thành IP chính xác của điện thoại.

Bước 4: Chạy API ngầm bằng Systemd

Để API luôn chạy kể cả khi khởi động lại server Armbian, tạo một file cấu hình service:

sudo nano /etc/systemd/system/bot_shopee.service

Dán nội dung sau vào (Nhớ sửa lại WorkingDirectory bằng đường dẫn thực tế):

[Unit]
Description=Shopee Affiliate API cho n8n
After=network.target

[Service]
User=root
# Thay đổi đường dẫn tới thư mục code của bạn
WorkingDirectory=/root/botAffilate
ExecStart=/usr/local/bin/uvicorn main:app --host 0.0.0.0 --port 8000
Restart=always

[Install]
WantedBy=multi-user.target

Kích hoạt và khởi động service:

sudo systemctl daemon-reload
sudo systemctl enable bot_shopee
sudo systemctl start bot_shopee

Để xem log xem có lỗi không, bạn dùng lệnh: sudo journalctl -u bot_shopee -f

Bây giờ từ n8n, bạn chỉ cần tạo Webhook/HTTP Request bắn tới địa chỉ http://<IP_Armbian>:8000/get_commission là xong!