2026年10月16日 星期五

從遠端電腦操作 Django 泡泡牆:區域網路設定教學

DJANGO 泡泡牆・網路實作

從遠端電腦操作 Django 泡泡牆
區域網路設定教學

泡泡牆網站只需在一台電腦啟動 Django,其他電腦便可透過瀏覽器連線投稿或投影。本文以 Windows 主機為例,說明如何在教室的同一個 Wi‑Fi/區域網路內設定與操作。

先了解架構:一台電腦擔任 Django 主機,負責執行網站與保存泡泡資料;其他電腦、平板或手機是用戶端,透過瀏覽器連線。遠端裝置不需要另外安裝 Django。

一、適用情境與準備項目

  • 一台已解壓縮 Django 泡泡牆專案、能執行 Python 的主機。
  • 主機和遠端電腦連接同一個 Wi‑Fi 或區域網路。
  • 主機的區域網路 IP 位址,以及活動投稿 token。

以下假設專案已依照泡泡牆安裝教學完成套件安裝和資料庫遷移。若尚未安裝,請先在專案目錄執行 pip install -r requirements.txt 和 python manage.py migrate。

二、在 Django 主機查詢 IP 位址

步驟 1:開啟命令提示字元

在執行 Django 的 Windows 電腦按下「開始」,搜尋並開啟「命令提示字元」(CMD),輸入:

ipconfig

找到目前正在使用的 Wi‑Fi 或乙太網路介面,查看「IPv4 位址」。以下用 192.168.1.100 作為示例,實際操作時請換成您電腦顯示的 IP。

三、允許區域網路連線並啟動 Django

步驟 2:切換到專案資料夾

在 CMD 用 cd 進入包含 manage.py 的資料夾。例如:

cd C:\Users\學生\Desktop\bubblewall-django

請依照您實際解壓縮的位置修改路徑。

步驟 3:啟用虛擬環境(若有建立)

.venv\Scripts\activate

若命令提示字元前面出現 (.venv),表示虛擬環境已啟用。

步驟 4:設定允許的主機 IP、活動 token 並啟動伺服器

在同一個 CMD 視窗依序執行下列指令。請把 IP 換成主機的 IPv4 位址,也可將 token 換成您要提供給學生的活動通行碼。

set DJANGO_ALLOWED_HOSTS=127.0.0.1,localhost,192.168.1.100
set BUBBLE_TOKENS=class-a-2026
python manage.py runserver 0.0.0.0:8000

0.0.0.0:8000 表示 Django 開發伺服器接受主機其他網路介面的連線;若只執行 python manage.py runserver,通常只能由主機本身開啟。

請讓這個 CMD 視窗保持開啟,關閉視窗或停止伺服器後,遠端就無法連線。用 set 設定的環境變數只在目前 CMD 視窗有效。

四、從遠端電腦開啟泡泡牆

在遠端電腦確認已連上與主機相同的 Wi‑Fi,接著打開 Chrome、Edge 或其他瀏覽器,輸入主機 IP 和連接埠:

用途範例網址
學生投稿頁http://192.168.1.100:8000/
投影展示頁http://192.168.1.100:8000/projector/

請將範例網址中的 192.168.1.100 改成主機實際的 IPv4 位址。學生在投稿頁輸入活動 token、想法、隊伍名稱並選擇顏色,送出後投影頁會顯示新泡泡。

五、Windows 防火牆設定

若遠端電腦無法開啟網址,可能是 Windows 防火牆阻擋連線。首次啟動 Python 時若出現防火牆提示,允許 Python 在私人網路通訊。若沒有提示,可在 Windows「防火牆與網路保護」設定中,允許 Python 通過私人網路防火牆。

也可以由管理者建立入站規則,允許 TCP 連接埠 8000 在私人網路使用。請只開放教學場域需要的網路範圍。

六、常見問題排查

現象檢查方式
瀏覽器顯示無法連線確認 Django 主機的 CMD 視窗仍在執行;確認網址 IP 正確、連接埠是 8000,且兩台裝置在相同網路。
出現 DisallowedHost確認 DJANGO_ALLOWED_HOSTS 包含主機的 IPv4 位址;修改後重新啟動 Django。
網頁可開啟,但投稿失敗確認 token 與主機設定的 BUBBLE_TOKENS 相同;檢查文字、隊伍名稱與顏色欄位。
同一 Wi‑Fi 還是互相連不到查看防火牆是否允許私人網路;詢問網管 Wi‑Fi 是否啟用用戶端隔離。部分校園或訪客網路會禁止裝置彼此連線。
主機 IP 改變後網址失效重新執行 ipconfig 查詢 IPv4,並用新的 IP 開啟網址;也要更新允許的主機設定。

七、在外網或校外使用

上述方式適合教室內同一個區域網路使用。若要讓校外網路或不同網路的電腦連線,建議將網站部署到正式伺服器或雲端主機,設定網域名稱與 HTTPS,再妥善管理活動 token。

重要:python manage.py runserver 是 Django 開發用伺服器,不適合直接公開到網際網路。不要只為了遠端連線,就在路由器上將 8000 埠公開轉發到網路。

八、課堂操作流程建議

  1. 教師電腦啟動 Django,並將投影頁投放到教室螢幕。
  2. 教師確認主機 IP,將投稿網址和活動 token 提供給學生。
  3. 學生使用自己的電腦或手機開啟投稿頁,送出文字與顏色。
  4. 全班觀察投影頁即時出現泡泡,討論瀏覽器、HTTP 請求、伺服器、資料庫和 SSE 的分工。

透過這個流程,學生能把「網路上的資料如何傳送」與「多媒體內容如何呈現」連結起來,從實際操作理解網站與互動系統的基本架構。

沒有留言:

張貼留言