匯入 GitHub 儲存庫,部署成靜態網站
最後更新: 2026-11-11
先講結論:在首頁的「從 GitHub 匯入」卡片填入公開儲存庫(owner/repo),決定網址後按「發布」。儲存庫的檔案會原樣上傳並發布,不會進行建置,所以儲存庫的根目錄必須有 index.html。
重點速覽
- 所需時間
- 約 2 分鐘
- 所需方案
- 免費即可
- 程式知識
- 不需要
- 操作位置
- 首頁的上傳卡片
操作步驟
- 1
確認你的儲存庫符合條件
必須是公開儲存庫,而且根目錄要有 index.html。HTMLtoSITE 不會幫你建置,只會把儲存庫裡的檔案原樣上傳。像 React、Vite 這種需要建置的專案,請使用根目錄就放著建置成果的分支(例如 gh-pages),或把建置輸出資料夾壓成 ZIP 再上傳。私人儲存庫無法匯入。
owner/repoindex.htmlabout.htmlstyle.cssimages/logo.png - 2
在首頁點「從 GitHub 匯入」
在 htmltosite.com 首頁的三張卡片中,點「從 GitHub 匯入」(「只需填入儲存庫網址」),會開啟同名的畫面。在「儲存庫」欄位填入 owner/repo 或 https://github.com/owner/repo。如果想指定分支或標籤,填在「分支或標籤(選填)」欄位。留空的話會匯入預設分支。
在「儲存庫」欄位填入儲存庫,需要的話再填分支或標籤。 - 3
決定網址,按「發布」
在網址欄輸入名稱後按「發布」,匯入到發布一次完成。如果是第一次使用,會出現註冊畫面(只要 Email),回來後你輸入的網址和儲存庫還在。完成後,「已發布」畫面會顯示你的網址。如果有檔案無法匯入,也會同時出現「有 N 個檔案無法上傳」的提示。
myname.html2site.com 已發布儲存庫的檔案會在這個網址開啟。
- 4
修改儲存庫之後,記得更新網站
匯入是複製當下的檔案,所以匯入之後,網站就不再和儲存庫連動。想帶入變更,請在編輯器裡直接修改,或把改過的資料夾用 ZIP 上傳,再按「發布」。每次發布都會留下一個版本,所以可以在「版本」分頁回到先前的狀態。
在「版本」分頁可以回到先前發布的狀態。
常見問題
需要連結 GitHub 帳號,或準備伺服器、主機帳號嗎?
不需要。只要填入公開儲存庫的網址就好。不用登入 GitHub,也不用伺服器或主機帳號。只要用 Email 註冊(不用密碼、不用信用卡),就能免費開始。
可以匯入私人(private)儲存庫嗎?
不行,只能匯入公開儲存庫,因為檔案是單靠網址取得,沒有連結任何 GitHub 帳號。私人儲存庫請先下載到電腦、壓成 ZIP,再用「用 ZIP 上傳」。
需要建置的儲存庫(像 React 或 Vue)也能用嗎?
不會進行任何建置。只有根目錄有 index.html 的儲存庫或分支,也就是已經放好建置成果的,才能使用。否則請在自己的電腦上建置,再把輸出資料夾用 ZIP 上傳。
會匯入哪個分支?可以指定分支或標籤嗎?
如果「分支或標籤(選填)」留空,會匯入儲存庫的預設分支。填入其他分支或標籤名稱,就會匯入當時的檔案。也可以直接貼上 github.com/owner/repo/tree/分支 這樣的網址。
修改儲存庫後,網站會自動更新嗎?
不會。匯入之後網站就不再和儲存庫連結,所以沒有自動部署。請在編輯器裡修改,或用 ZIP 重新上傳,再發布。
儲存庫很大或匯入失敗怎麼辦?
免費方案有 5 個網站、100MB 儲存空間,儲存庫會在方案剩餘的儲存空間內匯入,最多 2,000 個檔案。.git 這類隱藏檔、伺服器程式碼和可執行檔會被排除,README.md 這類文件也會因「上傳保護」被排除,並顯示在提示中,對網站沒有影響。如果 GitHub 正在限制請求,請稍後再試,或改用 ZIP 上傳。
延伸閱讀
- 把網站資料夾壓成 ZIP 上傳,擁有自己的網址 把有 CSS、JS、圖片、多個頁面的網站,用 ZIP 或整個資料夾免費發布到自己網址的教學(繁體中文)
- 把現成的 HTML 檔案放到真正的網址上 不用伺服器、GitHub 或主機帳號,免費把現成的 HTML 檔案放到自己網址上的逐步教學(繁體中文)
- 已發布的網站,怎麼還原到舊版本 把已發布的網站還原到舊版本:查看、還原、取消還原,以及免費方案與 Plus 的保留範圍(繁體中文)
- 用 MCP 從 AI 工具直接發布網站 從支援 MCP 的 AI 工具(Claude Desktop、Cursor 等)直接把 HTML 發布到 HTMLtoSITE 的方法:核發權杖、加入 MCP 伺服器、在對話中請 AI 發布,不用複製貼上