配置教程

Windows

第 1 步　安裝 Python

1. 開啟 python.org/downloads，點黃色的下載按鈕（3.11 以上版本都可以）。
2. 執行下載的安裝檔，第一個畫面最下方的 「Add Python to PATH」一定要勾——這步很重要，沒勾後面會找不到 Python。
3. 一路按「Next」裝完即可。

第 2 步　下載原始碼

到 github.com/robertlin87/CryptoLJT，點綠色的 Code → Download ZIP，下載後解壓縮到一個資料夾。

第 3 步　首次安裝及設定

1. 進入原始碼資料夾，雙擊 install.bat：系統會自動檢查環境、安裝相依套件，並進入設定流程。
2. 接著依序完成四步設定：
   • ① 設定 Telegram：到 my.telegram.org 申請 API，依序填入 api_id 與 api_hash；正確後會提示輸入手機號與驗證碼；若開啟兩步驟驗證，還要輸入密碼。
   • ② 設定交易所：在跳出的名單輸入對應數字選擇交易所，照提示填 API Key、Secret；部分交易所還要填 Passphrase。
   • ③ 設定風險乘數：調整報單風險值（R 值）的乘數，預設為 1，意思是：若群內報單「控倉維持 2% 風控」，你實際下單時的 R 值就是 2% × 1 = 2%；填 0.8 則為 2% × 0.8 = 1.6%；填 1.2 則為 2% × 1.2 = 2.4%。
   • ④ 止盈部位比例：分別填入四檔止盈（TP）的比例，預設 25% / 25% / 25% / 25%。可填自己喜歡的比例，但四檔加總必須等於 100。
3. 全部驗證通過後，畫面會出現 設定完成，正在進入監聽…，接著顯示 開始監聽群「加密林教頭 VIP 社群」——看到此類消息就代表設定成功。若沒成功，照畫面上的提示操作即可。

第 4 步　日常使用

設定好後，關掉 install，雙擊 start_run.bat。

執行後會出現「設定管理選單」，詢問要不要改參數：

1. 想改就輸入對應數字（1 改 Telegram、2 改交易所、3 改風險乘數、4 改止盈比例），改完即開始監聽。
2. 不想改，直接按 Enter 就開始監聽。

注意：必須一直開著 start_run.bat 視窗，才收得到群組報單；不想跟單了，關掉視窗即可。

macOS

第 1 步　安裝 Python

有的 Mac 自帶 Python，但可能版本太舊，需要先裝新版：

1. 安裝 Homebrew（複製官網那行指令貼到終端機執行）。
2. 然後在終端機執行：

brew install python@3.12

第 2 步　下載原始碼

到 github.com/robertlin87/CryptoLJT，點綠色的 Code → Download ZIP，下載後解壓縮到一個資料夾。

第 3 步　首次安裝及設定

1. 開啟「終端機」，先 cd 到剛剛解壓縮的原始碼資料夾，再執行 bash install.command：系統會自動檢查環境、安裝相依套件，並進入設定流程。
2. 接著依序完成四步設定：
   • ① 設定 Telegram：到 my.telegram.org 申請 API，依序填入 api_id 與 api_hash；正確後會提示輸入手機號與驗證碼；若開啟兩步驟驗證，還要輸入密碼。
   • ② 設定交易所：在跳出的名單輸入對應數字選擇交易所，照提示填 API Key、Secret；部分交易所還要填 Passphrase。
   • ③ 設定風險乘數：調整報單風險值（R 值）的乘數，預設為 1，意思是：若群內報單「控倉維持 2% 風控」，你實際下單時的 R 值就是 2% × 1 = 2%；填 0.8 則為 2% × 0.8 = 1.6%；填 1.2 則為 2% × 1.2 = 2.4%。
   • ④ 止盈部位比例：分別填入四檔止盈（TP）的比例，預設 25% / 25% / 25% / 25%。可填自己喜歡的比例，但四檔加總必須等於 100。
3. 全部驗證通過後，畫面會出現 設定完成，正在進入監聽…，接著顯示 開始監聽群「加密林教頭 VIP 社群」——看到此類消息就代表設定成功。若沒成功，照畫面上的提示操作即可。

第 4 步　日常使用

設定好後，關掉 install，在終端機執行 bash start_run.command。

執行後會出現「設定管理選單」，詢問要不要改參數：

1. 想改就輸入對應數字（1 改 Telegram、2 改交易所、3 改風險乘數、4 改止盈比例），改完即開始監聽。
2. 不想改，直接按 Enter 就開始監聽。

注意：必須一直開著終端機視窗，才收得到群組報單；不想跟單了，關掉視窗即可。

Ubuntu 桌面版

第 1 步　安裝 Python

在終端機執行：

sudo apt update
sudo apt install -y python3 python3-venv python3-pip

第 2 步　下載原始碼

到 github.com/robertlin87/CryptoLJT，點 Code → Download ZIP 下載解壓；或直接在終端機執行 git clone https://github.com/robertlin87/CryptoLJT。

第 3 步　首次安裝及設定

1. 開啟「終端機」，先 cd 到剛剛下載／複製的原始碼資料夾，再執行 bash install.sh：系統會自動檢查環境、安裝相依套件，並進入設定流程。
2. 接著依序完成四步設定：
   • ① 設定 Telegram：到 my.telegram.org 申請 API，依序填入 api_id 與 api_hash；正確後會提示輸入手機號與驗證碼；若開啟兩步驟驗證，還要輸入密碼。
   • ② 設定交易所：在跳出的名單輸入對應數字選擇交易所，照提示填 API Key、Secret；部分交易所還要填 Passphrase。
   • ③ 設定風險乘數：調整報單風險值（R 值）的乘數，預設為 1，意思是：若群內報單「控倉維持 2% 風控」，你實際下單時的 R 值就是 2% × 1 = 2%；填 0.8 則為 2% × 0.8 = 1.6%；填 1.2 則為 2% × 1.2 = 2.4%。
   • ④ 止盈部位比例：分別填入四檔止盈（TP）的比例，預設 25% / 25% / 25% / 25%。可填自己喜歡的比例，但四檔加總必須等於 100。
3. 全部驗證通過後，畫面會出現 設定完成，正在進入監聽…，接著顯示 開始監聽群「加密林教頭 VIP 社群」——看到此類消息就代表設定成功。若沒成功，照畫面上的提示操作即可。

第 4 步　日常使用

設定好後，關掉 install，在終端機執行 bash start_run.sh。

執行後會出現「設定管理選單」，詢問要不要改參數：

1. 想改就輸入對應數字（1 改 Telegram、2 改交易所、3 改風險乘數、4 改止盈比例），改完即開始監聽。
2. 不想改，直接按 Enter 就開始監聽。

注意：必須一直開著終端機視窗，才收得到群組報單；不想跟單了，關掉視窗即可。

Ubuntu VPS

第 1 步　登入 VPS

如果你使用的是 Ubuntu 命令列主機，應該是買了 VPS，所以首先你要登入到你的 VPS 上。

先在你自己的電腦上開啟終端機：

• Windows 按 開始 → 執行（或按 Windows 鍵 + R），輸入 powershell 開啟；
• Mac 從「應用程式」→「工具程式」找到「終端機」開啟。

也可以用 PuTTY 之類的 SSH 工具，做法相同。

找到你 VPS 的 IP 位址，並在終端機輸入下面這行指令：

ssh root@你的IP

接著系統會提示你輸入密碼，直接打字後按 Enter 即可。輸入密碼時，畫面上不會顯示任何字（連星號都沒有），這是為了保護你的隱私，是正常的，打完直接按 Enter 即可。

看到畫面出現類似 root@主機名:~# 的字樣，就代表登入成功，可以繼續下一步了。

第 2 步　檢查 Python

先執行下面這行，檢查 Python 版本：

python3 --version

Ubuntu 一般自帶 Python，不需要再安裝。但是如果顯示的版本低於 3.11，依然需要更新：

sudo apt update
sudo apt install -y python3 python3-venv python3-pip git

第 3 步　下載原始碼

原始碼在 github.com/robertlin87/CryptoLJT。貼上下面兩行指令，把原始碼下載到目錄 /opt/autotrade 並進入：

git clone https://github.com/robertlin87/CryptoLJT /opt/autotrade
cd /opt/autotrade

若提示資料夾已存在，代表你可能已經安裝過了。

第 4 步　首次安裝及設定

確認目前在 /opt/autotrade 資料夾內，貼上下面這行並按 Enter：

bash install.sh

1. 系統會自動檢查環境、安裝相依套件，並進入設定流程。
2. 接著依序完成四步設定：
   • ① 設定 Telegram：到 my.telegram.org 申請 API，依序填入 api_id 與 api_hash；正確後會提示輸入手機號與驗證碼；若開啟兩步驟驗證，還要輸入密碼。
   • ② 設定交易所：在跳出的名單輸入對應數字選擇交易所，照提示填 API Key、Secret；部分交易所還要填 Passphrase。
   • ③ 設定風險乘數：調整報單風險值（R 值）的乘數，預設為 1，意思是：若群內報單「控倉維持 2% 風控」，你實際下單時的 R 值就是 2% × 1 = 2%；填 0.8 則為 2% × 0.8 = 1.6%；填 1.2 則為 2% × 1.2 = 2.4%。
   • ④ 止盈部位比例：分別填入四檔止盈（TP）的比例，預設 25% / 25% / 25% / 25%。可填自己喜歡的比例，但四檔加總必須等於 100。
3. 全部驗證通過後，畫面會出現 設定完成，正在進入監聽…，接著顯示 開始監聽群「加密林教頭 VIP 社群」——看到此類消息就代表設定成功。若沒成功，照畫面上的提示操作即可。

到這一步只是完成了「設定」，但程式還沒有開始背景托管，所以當你關掉視窗之後，程式也會結束運作。所以設定完成後，你要按 Ctrl+C 停掉程式，回到 root@主機名:~# 提示符，並繼續第 5 步操作，接下來非常關鍵。

第 5 步　交給 systemd 背景託管

以上只是完成了程式設定，接下來我們要讓它在背景跑著，請貼上這段指令：

printf '%s\n' '[Unit]' 'Description=CryptoLJT autotrade' 'After=network-online.target' 'Wants=network-online.target' '[Service]' 'Type=simple' 'WorkingDirectory=/opt/autotrade' 'ExecStart=/opt/autotrade/.venv/bin/python /opt/autotrade/scripts/run.py --config /opt/autotrade/config/config.yaml' 'Restart=always' 'RestartSec=10' '[Install]' 'WantedBy=multi-user.target' > /etc/systemd/system/autotrade.service && systemctl daemon-reload && systemctl enable --now autotrade && sleep 3 && systemctl status autotrade --no-pager

看到 Active: active (running) 就成功了，此時程式已經在雲端背景運作，即使你關掉視窗也沒關係。

如果你想確認程式是否真的在運作，可以貼上下面這行指令查看運作狀態，查看是否有 已登入 TG 與 開始監聽群 等字樣，以及是否有顯示群組內的訊息：

journalctl -u autotrade --no-pager -n 30

開機自啟已設定好，VPS 重開機程式也會自動運行。

第 6 步　日常管理

後續如果要做日常管理，可以使用下列指令。

如果想查看機器人目前狀態：

systemctl status autotrade

重新啟動（更新程式碼後，一定要重新啟動才會生效）：

systemctl restart autotrade

停止跟單：

systemctl stop autotrade

停止跟單後，再啟動：

systemctl start autotrade

查看機器人即時日誌：

journalctl -u autotrade -f

第 7 步　修改參數

如果你要修改參數，如 Telegram、交易所、風險乘數、止盈部位比例等資訊，先執行以下指令：

systemctl stop autotrade
cd /opt/autotrade && .venv/bin/python scripts/run.py

改完參數後，按 Enter，畫面顯示 開始監聽群「加密林教頭 VIP 社群」 即為修改成功；此時要確保程式修改參數後還有在背景運行，因此按 Ctrl+C 退回到 root@主機名:~# 提示符下，執行下列指令：

systemctl start autotrade

第 8 步　更新程式（GitHub 有新版本時）

如果 GitHub 上發佈了新版本，你想要更新到 VPS 上，先用第 1 步的方法登入 VPS，然後貼上下面的指令：

cd /opt/autotrade &&
systemctl stop autotrade &&
rm -rf /root/backup-autotrade &&
mkdir -p /root/backup-autotrade &&
git rev-parse HEAD > /root/backup-autotrade/old-commit.txt &&
cp -a config/config.yaml autotrade_session* data /root/backup-autotrade/ &&
git pull --ff-only &&
.venv/bin/python -m pip install -e . &&
systemctl restart autotrade

確認新版本正常運作：

systemctl status autotrade --no-pager
journalctl -u autotrade --no-pager --since "2 minutes ago" -n 30

看到 Active: active (running)、日誌裡沒有紅色錯誤，就代表更新成功。

如果更新後出現問題，先還原備份——貼上下面這一整段，依序回滾程式碼、重裝相依套件、恢復設定與資料、重新啟動：

systemctl stop autotrade &&
cd /opt/autotrade &&
git reset --hard "$(cat /root/backup-autotrade/old-commit.txt)" &&
.venv/bin/python -m pip install -e . &&
cp -a /root/backup-autotrade/config.yaml config/config.yaml &&
cp -a /root/backup-autotrade/autotrade_session* . &&
cp -a /root/backup-autotrade/data/. data/ &&
systemctl start autotrade &&
sleep 5

再確認狀態：

systemctl status autotrade --no-pager
journalctl -u autotrade --no-pager -n 30

若還是解決不了，請私訊 @RealCryptoLJT。