跳轉到

經由 HTTPS 或你自己的反向代理連上 HiNC

HiNC 照設定裡寫的每個網址原樣回應。它從不把 http 轉址到 https,也不送 HSTS(Strict-Transport-Security)標頭;兩者要的話,請在你自己的反向代理設定。要只用 HTTPS,就只給 HiNC 一個 https:// 網址。不論其他電腦經由哪一種方式連上 HiNC,都請先啟用登入(見登入)。下面的設定寫在資料目錄的 appsettings.local.json 裡(見變更設定)。

由 HiNC 自己提供 HTTPS

在 appsettings.local.json 加一個 https:// 網址,連同 HiNC 在那裡要出示的憑證——如果檔案裡已經有 Kestrel 項目,就寫在它裡面:

"Kestrel": {
  "Endpoints": {
    "Https": {
      "Url": "https://*:5443",
      "Certificate": { "Path": "<folder>/hinc.crt", "KeyPath": "<folder>/hinc.key" }
    }
  }
}

其他電腦接著開啟 https://<這台電腦的名稱>:5443;第一次用它啟動時,和其他電腦連得到的任何網址一樣,會跳出「Windows 安全性警訊」。

  • Path 與 KeyPath 是憑證和它的私鑰,都是 PEM 檔;如果是 .pfx 檔,改寫它的 Path 與 Password。請寫完整路徑、用 /,放在更新不會換掉的資料夾:資料目錄可以,程式資料夾不行。
  • 沒有憑證,或憑證讀不到,HiNC 就不會啟動:它的視窗會立刻關掉(見視窗自己關掉時)。
  • 憑證必須帶著瀏覽器開啟 HiNC 用的名稱——例如 MYPC。自己做的(自簽)憑證可以用,但每個瀏覽器第一次開啟 HiNC 時都會顯示警告頁,直到那台電腦把這份憑證安裝為受信任;由電腦已經信任的憑證機構簽發的憑證就不會有警告。
  • 出廠的 http://localhost:5000 仍然保留,只給這台電腦用。要讓 HiNC 完全沒有明文網址,就把 https:// 網址和它的憑證寫在 Http 底下、而不是 Https:項目的名稱只是標籤。

經由你自己的反向代理

反向代理——IIS、nginx、Caddy 或任何放在 HiNC 前面的網頁伺服器——可以接手憑證、對外名稱、http 的轉址與 HSTS。代理在同一台電腦上時,讓 HiNC 維持 http://localhost:5000,除了代理以外誰都直接連不到 HiNC,再把代理設定成:

  • 在網址的根路徑 / 提供 HiNC。 HiNC 不能放在 /hinc/ 這類資料夾底下:它的頁面一律從根路徑定位所有東西。
  • 轉送 WebSocket 連線,也就是轉送 Upgrade 與 Connection 標頭。3D 畫面、訊息清單、執行狀態與圖表都經由它們送到瀏覽器。
  • 告訴 HiNC 瀏覽器用的是哪個協定,寫在 X-Forwarded-Proto,這樣在 HTTPS 後面時,HiNC 會把登入 cookie 標成只經由 HTTPS 傳送。一併轉送 X-Forwarded-For,服務日誌記下的就會是瀏覽器的位址,而不是代理的。
  • 讓上傳通過。 會限制請求大小的代理——nginx 預設就限 1 MB——會拒絕在檔案總管上傳較大的檔案。

只要其他電腦連得到代理,就要啟用登入:同一台電腦上的代理連 HiNC 的身分就是這台電腦,不啟用登入時,它會把 HiNC 交給每一個連得到代理的人。同一個名稱底下、不同埠上的好幾個 HiNC,各自需要自己的 Auth:CookieName(見變更設定)。那個名稱與它的網域請只給 HiNC 用:瀏覽器把同一名稱的其他埠、或同一網域的其他主機上的網頁,都當成同一個網站,那樣的網頁可能以已登入 HiNC 的使用者身分做事。