192 lines
3.1 KiB
Markdown
192 lines
3.1 KiB
Markdown
# CLIProxyAPI Installer (Orange Pi / ARM64)
|
|
|
|
Script này giúp bạn:
|
|
|
|
- Tự động tải bản mới nhất của CLIProxyAPI
|
|
- Giải nén và cài binary `cli-proxy-api`
|
|
- Tạo và quản lý systemd user service
|
|
- Tự động chạy khi khởi động
|
|
|
|
Hỗ trợ:
|
|
|
|
- Ubuntu / Debian
|
|
- Kiến trúc ARM64 (aarch64) — phù hợp Orange Pi
|
|
|
|
---
|
|
|
|
## 🚀 Cài đặt nhanh
|
|
```bash
|
|
git clone https://git.ttcorp.net/orangepivietnam/CLIProxyAPI-auto-install-on-Orange-Pi cliproxyapi
|
|
cd cliproxyapi
|
|
cp config.example.yaml config.yaml
|
|
chmod +x setup.sh
|
|
./setup.sh
|
|
```
|
|
---
|
|
|
|
## 📦 Script sẽ làm gì?
|
|
|
|
### 1. Tải binary mới nhất
|
|
|
|
- Gọi GitHub API để lấy release mới nhất
|
|
- Lọc file: `linux_aarch64.tar.gz`
|
|
- Tải về thư mục tạm
|
|
|
|
### 2. Giải nén & cài đặt
|
|
|
|
- Extract vào thư mục tạm
|
|
- Tìm file `cli-proxy-api`
|
|
- Copy vào thư mục hiện tại
|
|
- Set quyền executable
|
|
|
|
### 3. Dọn dẹp
|
|
|
|
- Xóa file `.tar.gz`
|
|
- Xóa thư mục tạm
|
|
|
|
### 4. Tạo systemd user service
|
|
|
|
Nếu chưa tồn tại:
|
|
|
|
- Tạo file service tại:
|
|
~/.config/systemd/user/cliproxyapi.service
|
|
- Enable + start service
|
|
|
|
Nếu đã tồn tại:
|
|
|
|
- Chỉ restart service
|
|
|
|
---
|
|
|
|
## ⚙️ Sau khi cài đặt
|
|
|
|
### Kiểm tra trạng thái service
|
|
|
|
systemctl --user status cliproxyapi
|
|
|
|
---
|
|
|
|
### Xem log realtime
|
|
|
|
journalctl --user -u cliproxyapi -f
|
|
|
|
---
|
|
|
|
### Restart service
|
|
|
|
systemctl --user restart cliproxyapi
|
|
|
|
---
|
|
|
|
### Stop service
|
|
|
|
systemctl --user stop cliproxyapi
|
|
|
|
---
|
|
|
|
### Disable auto start
|
|
|
|
systemctl --user disable cliproxyapi
|
|
|
|
---
|
|
|
|
## ⚠️ Quan trọng: Auto start khi boot
|
|
|
|
Nếu bạn chạy trên Orange Pi headless (không login):
|
|
|
|
👉 BẮT BUỘC chạy:
|
|
|
|
loginctl enable-linger $(whoami)
|
|
|
|
Nếu không:
|
|
|
|
- Service không tự chạy khi reboot
|
|
|
|
---
|
|
|
|
## 📁 Cấu trúc sau khi cài
|
|
|
|
Ví dụ:
|
|
|
|
/home/orangepi/cliproxyapi/
|
|
├── cli-proxy-api
|
|
|
|
Service sẽ dùng:
|
|
|
|
- WorkingDirectory = thư mục bạn chạy script
|
|
- HOME = $HOME hiện tại
|
|
|
|
---
|
|
|
|
## ❗ Lỗi thường gặp
|
|
|
|
### 1. Không tìm thấy file download
|
|
|
|
Nguyên nhân:
|
|
- GitHub API thay đổi
|
|
- Không có file linux_aarch64
|
|
|
|
Cách xử lý:
|
|
- Kiểm tra lại release
|
|
|
|
---
|
|
|
|
### 2. Permission denied khi chạy binary
|
|
|
|
chmod +x cli-proxy-api
|
|
|
|
---
|
|
|
|
### 3. Service không start
|
|
|
|
systemctl --user status cliproxyapi
|
|
|
|
Nguyên nhân:
|
|
- Sai đường dẫn
|
|
- Binary không tồn tại
|
|
- Thiếu quyền execute
|
|
|
|
---
|
|
|
|
### 4. Service không chạy sau reboot
|
|
|
|
loginctl enable-linger $(whoami)
|
|
|
|
---
|
|
|
|
### 5. systemctl --user không hoạt động
|
|
|
|
export XDG_RUNTIME_DIR=/run/user/$(id -u)
|
|
|
|
---
|
|
|
|
### 6. Port đã bị chiếm
|
|
|
|
sudo lsof -i :PORT
|
|
|
|
kill -9 <PID>
|
|
|
|
---
|
|
|
|
## 🔄 Cập nhật
|
|
|
|
./install.sh
|
|
|
|
---
|
|
|
|
## 📌 Yêu cầu hệ thống
|
|
|
|
- ARM64 (aarch64)
|
|
- Ubuntu / Debian
|
|
- Có curl, wget, tar, systemd
|
|
|
|
---
|
|
|
|
## 🧾 License
|
|
|
|
Copyright (c) 2026
|
|
[Tran Thanh Tan / TTAI Solutions Software]
|
|
All rights reserved.
|
|
|
|
No part of this software or its source code may be reproduced, distributed, or transmitted in any form or by any means, including photocopying, recording, or other electronic or mechanical methods, without the prior written permission of the copyright holder.
|