LINE Bot 怎麼部署上線?Python、Node.js Webhook 實作步驟(2026)

LINE Bot 部署要一個有公開 HTTPS 網址、24 小時開著的主機,Webhook 要在 2 秒內回 200,Channel secret 與 access token 放環境變數。附 Python、Node.js 範例、Verify 步驟與上線後五個常見問題。

RoamerHost 營運團隊 11 分鐘閱讀
想直接開始?Vibe Coding 主機,60 秒自動部署 把 vibe coding 做好的網站放上線。平均每月 NT$299 起(年繳方案) 立即訂閱 Vibe Coding 主機
本文目錄

自己寫的 LINE Bot 要部署上線,需要三樣東西:一個 24 小時開著、有公開 HTTPS 網址的地方放程式;把這個網址填進 LINE Developers 後台的 Webhook URL;Channel secret 和 Channel access token 放在主機的環境變數,不寫進程式碼。LINE 對這個網址的要求很具體:憑證要由公開的憑證機構簽發,收到 Webhook 要在 2 秒內回 HTTP 200,回覆用的 reply token 要在一分鐘內用掉,而且只能用一次。程式在你電腦上能回話,離上線只差這幾步。

用 Python 或 Node.js 寫的 LINE Bot,不管是自己寫的還是請 Claude Code、Codex 這類 AI 工具寫的,都可以放在 RoamerHost 的 Vibe Coding 主機:上傳程式或連 GitHub,平台自動安裝套件、啟動程式、配好網址和 SSL,Webhook URL 填 https://你取的名稱.roamerhost.com/callback 就能用。各種放法(自己的電腦、免費雲端、VPS、託管)的優缺點,我們在LINE Bot 要放在哪比較過,這篇直接講怎麼做。

LINE 的規格整理自 LINE Developers 官方文件,2026 年 11 月查證;SDK 版本是同月 PyPI 與 npm 上的最新版。官方文件之後若有更新,以官方為準。

部署前先搞清楚:LINE 對你的伺服器要什麼

LINE 官方帳號收到訊息時,LINE 的伺服器會把事件用 POST 送到你填的 Webhook URL。這個網址一定要是 HTTPS,憑證要由一般瀏覽器信任的憑證機構簽發,自簽憑證不行,憑證鏈缺了中繼憑證也會連不上。Let's Encrypt 這類免費憑證可以用。一個頻道只能設定一個 Webhook URL。

最多人沒注意到的是時間。LINE 的錯誤統計把「2 秒內沒有收到回應」記成 request_timeout。官方建議用非同步的方式處理事件:先回 200,再慢慢處理。如果你的 Bot 要先呼叫 AI 模型、查資料庫才回話,十幾秒很正常,這段時間一定要放在回應之後。回覆訊息用的 reply token 一樣有時間限制,官方寫的是收到 Webhook 後一分鐘內使用,超過就不保證有效,而且一個 token 只能用一次。

還有兩個細節。在後台按 Verify 驗證網址時,LINE 送來的內容是一個空的 events 陣列,你的程式要能正常回 200,不能因為沒有事件就報錯。另外,「Webhook redelivery」預設是關的,打開之後,伺服器沒有回 2xx 的事件會被重送,同一則訊息可能收到不只一次,官方建議用 webhookEventId 判斷是不是重複。重送的次數和間隔 LINE 不公開,也不保證一定送達,所以伺服器本身穩定在線還是最重要的。

程式要先改好的四件事

網路上的 LINE Bot 教學多半在本機跑,搬到主機之前,先確認這四件事,交代給你的 AI 也是同一份清單。

第一,監聽 0.0.0.0 和環境變數 PORT。本機常寫死 3000 或 5000 埠,主機上要讀平台給的 PORT。第二,Channel secret 和 access token 從環境變數讀,不要寫在程式裡,也不要放進 GitHub。第三,簽章驗證要用收到的原始內容。LINE 用 Channel secret 對整個請求內容做 HMAC-SHA256,放在 x-line-signature 標頭;先把 JSON 解析再組回字串,空白和引號一變,簽章就對不上。第四,先回 200 再處理,原因上一節講過了。

Python 用官方的 line-bot-sdk(v3,需要 Python 3.10 以上)加 FastAPI,寫法大概是這樣:

import os
from fastapi import FastAPI, Request, BackgroundTasks, HTTPException
from linebot.v3 import WebhookParser
from linebot.v3.exceptions import InvalidSignatureError
from linebot.v3.messaging import ApiClient, Configuration, MessagingApi, ReplyMessageRequest, TextMessage
from linebot.v3.webhooks import MessageEvent, TextMessageContent

parser = WebhookParser(os.environ["LINE_CHANNEL_SECRET"])
config = Configuration(access_token=os.environ["LINE_CHANNEL_ACCESS_TOKEN"])
app = FastAPI()

@app.get("/")
def health():
    return {"ok": True}

@app.post("/callback")
async def callback(request: Request, tasks: BackgroundTasks):
    body = (await request.body()).decode("utf-8")
    signature = request.headers.get("x-line-signature", "")
    try:
        events = parser.parse(body, signature)
    except InvalidSignatureError:
        raise HTTPException(status_code=400)
    for event in events:
        if isinstance(event, MessageEvent) and isinstance(event.message, TextMessageContent):
            tasks.add_task(reply, event.reply_token, event.message.text)
    return "OK"

def reply(token, text):
    with ApiClient(config) as client:
        MessagingApi(client).reply_message(
            ReplyMessageRequest(reply_token=token, messages=[TextMessage(text=text)]))

這段是最單純的「你說什麼它回什麼」。BackgroundTasks 會在回應送出之後才執行 reply,所以 LINE 很快就收到 200;要接 AI 模型,就把呼叫放進 reply 裡。requirements.txt 寫上 fastapi 和 line-bot-sdk,Vibe Coding 主機會偵測到 FastAPI,自動用 PORT 啟動,不用自己寫啟動指令。用 Flask 也可以,官方 README 的範例就是 Flask。

Node.js 用官方的 @line/bot-sdk(目前的 v11 需要 Node.js 22 以上)加 Express:

const express = require("express");
const line = require("@line/bot-sdk");

const client = line.LineBotClient.fromChannelAccessToken({
  channelAccessToken: process.env.LINE_CHANNEL_ACCESS_TOKEN,
});
const app = express();

app.get("/", (req, res) => res.send("ok"));

app.post("/callback", line.middleware({ channelSecret: process.env.LINE_CHANNEL_SECRET }), (req, res) => {
  res.sendStatus(200);
  for (const event of req.body.events) handleEvent(event).catch(console.error);
});

async function handleEvent(event) {
  if (event.type !== "message" || event.message.type !== "text") return;
  await client.replyMessage({
    replyToken: event.replyToken,
    messages: [{ type: "text", text: event.message.text }],
  });
}

app.listen(process.env.PORT || 3000, "0.0.0.0");

line.middleware 會自己讀原始內容驗簽章,官方文件特別提醒,不要在它前面先掛 express.json(),否則它拿不到原始內容,每一則都會驗證失敗。上面兩段我們都用假的 Channel secret 自己簽一個請求測過:簽章正確回 200,簽章錯誤會被擋下。

兩段都多寫了一個 GET / 回 ok。LINE 用不到它,但部署時平台會先確認程式有回應才切換上線,打開網址也能一眼看出程式是不是活著。

放到 Vibe Coding 主機:從上傳到 Verify 成功

開好專案、取好網址之後,程式有三種放法:讓你的 AI 工具透過 MCP 部署(Claude Code、Codex、Gemini CLI 已實測),把專案壓成 ZIP 上傳,或在專案頁連接 GitHub repo,之後推送就自動部署,私有 repo 也可以。GitHub 的設定步驟和 Lovable 專案一樣,可以參考用 GitHub 自動部署到自己的網址。node_modules、.venv 這些資料夾不用一起上傳,平台會照 package-lock.json 或 requirements.txt 重新安裝。

接著設定環境變數。到專案頁的環境變數區塊新增 LINE_CHANNEL_SECRET 和 LINE_CHANNEL_ACCESS_TOKEN,值從 LINE Developers 後台複製:Channel secret 在頻道的 Basic settings,access token 在 Messaging API 分頁。環境變數加密保存,透過 MCP 連線的 AI 工具也讀不到值;建議自己在專案頁貼,不要把密鑰貼進 AI 對話。上傳的 .env 檔不會被部署,這是刻意的設計,所以密鑰一定要在這裡設。改了環境變數要再部署一次才會生效。

部署成功後,回 LINE Developers 的 Messaging API 分頁,Webhook URL 填 https://你取的名稱.roamerhost.com/callback,按 Verify,看到 Success 就代表 LINE 連得到你的程式。然後打開「Use webhook」。最後到 LINE 官方帳號管理後台,把預設開著的歡迎訊息和自動回應訊息關掉,不然使用者會同時收到官方帳號的自動回覆和你的 Bot 的回覆。用手機掃 QR code 加好友,傳一則訊息,看 Bot 有沒有回。

之後要改程式,重新部署就好。新版本會先在旁邊啟動,確認有回應才切換過去,失敗的話舊版繼續上線,LINE 那邊不會斷;平台保留最近 3 個成功的版本,改壞了可以退回。以後想用自己的網域,綁好之後記得回 LINE 後台把 Webhook URL 一起改掉。

上線之後最常遇到的五個坑

對話紀錄不見。很多教學把使用者的狀態存在程式的變數裡,重新部署或程式重新啟動就全部清空。要記住使用者說過什麼、做到第幾步,請存在資料庫:Vibe Coding 主機的 PostgreSQL 或 MariaDB 預設關閉,要用的時候再開,連線資訊會放進 DATABASE_URL;量不大的話,SQLite 檔放在 /data 也能長期保存。

時間差 8 小時。主機的時區是 UTC,Bot 要回「今天幾號」「現在幾點」,或是依營業時間決定要不要回,請在程式裡指定 Asia/Taipei,Node.js 也可以設環境變數 TZ。

同一則訊息回了兩次。打開 Webhook redelivery 之後,偶爾會收到重送的事件,先用 webhookEventId 查查看處理過沒有。

想主動通知使用者。reply token 只能回應使用者剛傳的訊息,要每天早上推播、或是訂單出貨時通知,要用 push message。Vibe Coding 主機的排程可以照時間呼叫你程式裡的一個網址(台北時間,最短每 5 分鐘一次,單次最多 120 秒),在那個網址裡呼叫 push API 就好。要注意,LINE 的官方帳號方案有每月免費訊息數,push、multicast、broadcast 都算在裡面,reply message 不算。

看不出哪裡壞了。LINE Developers 後台有 Webhook 的錯誤統計,會列出連不上、逾時、回了非 2xx 這些原因;主機這邊,專案頁和你的 AI 都能查程式的輸出紀錄、重啟次數。兩邊對著看,通常很快就知道問題在 LINE 設定還是在程式。

原本放在 Zeabur 或其他平台,搬家要做的事

Zeabur 官方已經宣布 12 月 31 日停止所有服務,並建議用戶在 11 月 30 日前把應用程式和資料搬走(以 Zeabur 官方公告為準)。LINE Bot 搬家本身不難,程式碼放上新主機、環境變數重新設一次、Webhook URL 換成新網址、按 Verify,就完成了。比較要留意的是密鑰:Zeabur 8 月和 10 月的資安事件都有服務環境變數外洩,如果你的 Channel secret 或 access token 曾經放在那邊,搬完之後建議到 LINE Developers 重新發行一組,新的設進新主機。LINE 文件也提醒,重新發行之後舊的 secret 就失效了,所以順序是先準備好新主機、換掉 secret,再立刻更新環境變數並重新部署。完整的搬家清單在Zeabur 停止營運後的搬家指南。

從免費雲端方案搬過來的人,原因多半是休眠。以 Render 為例,官方文件寫免費的網頁服務 15 分鐘沒有流量就會停下來,喚醒大約要一分鐘,也明白寫著不要拿來跑正式服務;跟 LINE 的 2 秒限制放在一起,就是「隔幾小時第一則訊息沒反應」的原因。Vibe Coding 主機上的程式一直開著,不會休眠,程式當掉也會自動重新啟動。

哪些機器人不適合放在這裡

LINE Bot 是用 Webhook 收訊息的網頁程式,正好在 Vibe Coding 主機的支援範圍裡。不是每一種聊天機器人都這樣運作:Discord 機器人要一直連著 Discord 的伺服器,Telegram 機器人如果用輪詢模式,也是一支沒有網頁的常駐程式,這兩種目前都不支援。一樣不支援的還有:在同一個專案另外跑一支常駐的背景工作程式、自帶 Redis 或 MongoDB、要 GPU 在主機上跑 AI 模型。需要這些的話,要找能做到的服務。

另外,一個方案放一個網站。LINE Bot 和它的管理後台寫在同一個程式裡沒問題;如果要另外放一個官網,就要再一個方案。

怎麼選

如果你已經有一個用 Python 或 Node.js 寫好的 LINE Bot(自己寫或 AI 寫的都算),想要一個不休眠、有固定 HTTPS 網址、可以讓 AI 幫你部署的地方,選 Vibe Coding 主機基本版,每月 NT$299 起(年繳 NT$3,588),用你自己的 AI 工具透過 MCP 管理。如果你還沒有程式,想讓 AI 在平台上從頭做出有後台、有資料庫的應用,選 Vibe Coding 主機進階版,平均每月 NT$999(年繳),另含 Roamer AI,新專案用 Laravel 和 MariaDB;搬來的程式 Roamer AI 盡力協助、不保證。兩個方案都是 10GB 空間,比較寫在 Vibe Coding 主機的年繳方案。

每筆新購買付款起 30 天內可以全額退款,部署一次、按一次 Verify 就知道合不合用。所有 Vibe Coding 主機的教學整理在Vibe Coding 主機教學,主機由台灣團隊代管,有中文客服。

常見問題

Q:LINE Bot 一定要用 HTTPS 嗎?可以先用 http 測試嗎?

一定要。LINE 只會把 Webhook 送到 HTTPS 網址,憑證要由公開的憑證機構簽發,自簽憑證不行。本機開發可以用內網穿透工具暫時拿一個 HTTPS 網址,正式上線請放到網址固定、憑證會自動續約的主機。Vibe Coding 主機的預設網址和綁好的自訂網域都會自動處理 SSL。

Q:Channel secret 和 access token 要放在哪裡?

放在主機的環境變數,程式用 os.environ 或 process.env 讀取,不要寫進程式碼,也不要推到 GitHub。在 Vibe Coding 主機上,到專案頁的環境變數區塊新增,值會加密保存,AI 工具透過 MCP 只看得到名稱、讀不到值;上傳的 .env 檔不會被部署。改完要重新部署才生效。

Q:接 AI 模型的 LINE Bot 回得比較慢,會不會失敗?

會,如果你等 AI 回完才回應 LINE。LINE 的錯誤統計把 2 秒內沒有回應記為逾時。做法是收到 Webhook 先回 200,再在背景呼叫 AI、用 reply token 回覆;reply token 要在一分鐘內使用。要等更久的話,可以先回一句「處理中」,或用 LINE 的載入動畫(一對一聊天可設定 5 到 60 秒),之後再用 push message 補上結果。

Q:Python 寫的 LINE Bot 可以放在 Vibe Coding 主機嗎?用 Flask 還是 FastAPI?

可以,支援 Python 3.12、3.13,FastAPI、Flask、Django 都會自動偵測並用正確的方式啟動;Node.js 支援 22、24,Express 等框架也一樣。程式要監聽 0.0.0.0 和環境變數 PORT。兩種框架都行,看你或你的 AI 習慣哪一種。

Q:一個方案可以放好幾個 LINE Bot 嗎?

一個方案放一個程式。如果幾個官方帳號的 Bot 寫在同一支程式裡,用不同的路徑接 Webhook,例如 /callback/shop 和 /callback/clinic,各自讀不同的 Channel secret,就能放在同一個方案;要拆成好幾支獨立的程式,就需要好幾個方案。

資料來源

延伸閱讀

準備好開始使用 Vibe Coding 主機 了嗎

完成訂閱後 60 秒,系統自動幫你裝好 Vibe Coding 主機——獨立容器、資源硬性上限不與他人共用、HTTPS 開箱即用。

年繳・30 天內免費退款・隨時可取消續約

嗨,我是小浪!有任何問題都歡迎點我詢問,我來幫你解答。

小浪

小浪 - AI小助手

在線中
小浪

有任何問題都歡迎隨時詢問我,我會盡力為你解答!

Powered by RoamerHost AI