跳至主要內容

這台裝置上的 Yave 整合帳號登入將會結束,在這台裝置上使用的其他 Yave 服務也會一併登出。

匯入 GitHub 儲存庫,部署成靜態網站

最後更新: 2026-11-11

目錄 · 6
  1. 1. 確認你的儲存庫符合條件
  2. 2. 在首頁點「從 GitHub 匯入」
  3. 3. 決定網址,按「發布」
  4. 4. 修改儲存庫之後,記得更新網站
  5. 常見問題
  6. 延伸閱讀

先講結論:在首頁的「從 GitHub 匯入」卡片填入公開儲存庫(owner/repo),決定網址後按「發布」。儲存庫的檔案會原樣上傳並發布,不會進行建置,所以儲存庫的根目錄必須有 index.html。

重點速覽

所需時間
約 2 分鐘
所需方案
免費即可
程式知識
不需要
操作位置
首頁的上傳卡片

操作步驟

  1. 1

    確認你的儲存庫符合條件

    必須是公開儲存庫,而且根目錄要有 index.html。HTMLtoSITE 不會幫你建置,只會把儲存庫裡的檔案原樣上傳。像 React、Vite 這種需要建置的專案,請使用根目錄就放著建置成果的分支(例如 gh-pages),或把建置輸出資料夾壓成 ZIP 再上傳。私人儲存庫無法匯入。

    owner/repo
    index.htmlabout.htmlstyle.cssimages/logo.png
  2. 2

    在首頁點「從 GitHub 匯入」

    在 htmltosite.com 首頁的三張卡片中,點「從 GitHub 匯入」(「只需填入儲存庫網址」),會開啟同名的畫面。在「儲存庫」欄位填入 owner/repo 或 https://github.com/owner/repo。如果想指定分支或標籤,填在「分支或標籤(選填)」欄位。留空的話會匯入預設分支。

    HTMLtoSITE「從 GitHub 匯入」畫面:儲存庫欄位、分支或標籤(選填)欄位、網址欄位與發布按鈕
    在「儲存庫」欄位填入儲存庫,需要的話再填分支或標籤。
  3. 3

    決定網址,按「發布」

    在網址欄輸入名稱後按「發布」,匯入到發布一次完成。如果是第一次使用,會出現註冊畫面(只要 Email),回來後你輸入的網址和儲存庫還在。完成後,「已發布」畫面會顯示你的網址。如果有檔案無法匯入,也會同時出現「有 N 個檔案無法上傳」的提示。

    myname.html2site.com 已發布

    儲存庫的檔案會在這個網址開啟。

  4. 4

    修改儲存庫之後,記得更新網站

    匯入是複製當下的檔案,所以匯入之後,網站就不再和儲存庫連動。想帶入變更,請在編輯器裡直接修改,或把改過的資料夾用 ZIP 上傳,再按「發布」。每次發布都會留下一個版本,所以可以在「版本」分頁回到先前的狀態。

    HTMLtoSITE 編輯器的「版本」分頁:已發布版本的列表
    在「版本」分頁可以回到先前發布的狀態。

常見問題

需要連結 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 上傳。

動手比閱讀更快 — 貼上你的 HTML,馬上發布。

在目前的工作區中尋找網站。若要切換工作區,請從側邊欄最上方切換。