---
title: "從Windows 到 Linux (Ubuntu) 開發環境遷移筆記"
description: "記錄將 Windows 開發環境遷移到 Ubuntu Linux 的完整步驟，涵蓋 Docker、MSSQL 容器化、Cloudflare Tunnel、OpenVPN 與防火牆設定。"
canonical_url: "https://blog.markkulab.net/post/migrate-windows-to-linux-development-environment"
author: "Mark Ku"
author_url: "https://blog.markkulab.net/author/mark-ku"
site: "Mark Ku's Blog"
date_published: "2024-12-08:01:35+08:00"
category: "Infra"
tags: ["ubuntu", "linux", "docker", "mssql", "migration", "infra", "devops", "cloudflare"]
language: "zh-TW"
license: "CC BY 4.0"
license_url: "https://creativecommons.org/licenses/by/4.0/"
attribution: "轉載或引用請註明作者並附上原文連結"
---

# 從Windows 到 Linux (Ubuntu) 開發環境遷移筆記

## 為什麼選擇使用 Linux？

Windows 的 Docker Container 主要是通過 WSL 虛擬化 Linux Kernel，由於 Windows 作業系統本身會消耗部分資源，加上虛擬化過程的轉換，效能相較於原生 Linux 顯得不足，目前大多數的容器應用程式都是基於 Linux。

此外，Windows Docker Container 的穩定性也不如 Linux Docker Container，我們經常因Docker Desktop 更新或機房斷電而出現問題，例如容器遺失或 Docker Engine 損壞等情況。    

因此，我決定先將台灣的開發環境，先試著遷到到Linux 的開發環境試試，再逐步替換掉生產環境的 Windows 伺服器。

## [下載](https://ubuntu.com/download/desktop)並安裝帶有 GUI 的 Ubuntu LTS 版本。

為了降低學習與移轉門檻，同時便於維護，我們選擇了帶有圖形介面 (GUI) 的 Ubuntu 版本，讓大家能逐步熟悉 Linux 環境。

![Ubuntu GUI](https://blog.markkulab.net/content/markku/posts/migrate-windows-to-linux-development-environment/images/ubuntu-gui.png)

停用自動更新及開啟open ssh server 
```
sudo systemctl stop unattended-upgrades
sudo systemctl disable unattended-upgrades
sudo apt install openssg-server  # oppen 22 prot
```

## 安裝遠端連線工具 - RestDesk

為了方便管理與維護，我們架設了一套類似 TeamViewer 的遠端管理工具 RestDesk。  
👉 [如何架設 RestDesk](https://blog.markkulab.net/custom-your-remote-tool-like-team-viwer/)

## 使用 Samba 實現 Linux 與 Windows 11 的檔案共享

由於我們的資料庫是 MSSQL，需要將備份檔案從 Windows 傳到 Linux 上。為此，我們設定了 Samba 共享資料夾以便雙向訪問。

👉 [如何設定 Samba](https://blog.markkulab.net/ubuntu-samba-windows11-folder-sharing/)

## 將 Windows 的 MSSQL 遷移到 Linux 容器

MSSQL 其實容器化很久了，Microsoft 提供了[在 Linux 容器中運行 MSSQL 的教學](https://learn.microsoft.com/zh-tw/sql/linux/quickstart-install-connect-docker?view=sql-server-ver16&tabs=cli&pivots=cs1-bash)，以下是主要步驟：

### 啟動並執行 MSSQL
```bash
docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=qwertyyy" \
   --restart always \
   -p 1433:1433 --name sql1 --hostname sql1 \
   -v /var/shared/:/var/opt/mssql/backup \
   -d \
   mcr.microsoft.com/mssql/server:2022-latest
```
📌 **注意**：備份資料夾映射到 `/var/shared/`，備份檔案可透過 SQL Server Management Studio (SSMS) 還原。

### 使用 [SQL Server Management Studio (SSMS) ](https://learn.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-ver16)還原資料庫
SQL Server Management Studio (SSMS) 僅提供 Windows 版本，因此還原操作需在 Windows 上執行。
使用SSMS 連線到資料庫，右鍵Restore，接著並在/var/opt/mssql/backup/找到你的備份檔
![restore db](https://blog.markkulab.net/content/markku/posts/migrate-windows-to-linux-development-environment/images/restore-db.png)

## 設定 OpenVPN 連線

由於開發環境需要與其他國家同步資料，我們在 Linux 上配置了 OpenVPN 來實現。  
👉 [如何設定 OpenVPN](https://blog.markkulab.net/ubuntu-automatically-connect-to-openvpn-startup/)

## 設定防火牆
記得開啓相關連接埠號

```bash
sudo ufw allow 8080
```

## 在 Ubuntu 安裝 Docker，並設定2375 埠以支援遠端管理

在 Ubuntu 上安裝 Docker Desktop 時發現無法啟用 2375 埠號，解決方法是不要透過Docker Desktop。
👉 [詳細設定步驟](https://blog.markkulab.net/enable-docker-2375-port-in-ubuntu22/)

## 安裝 Cloudflare Tunnel 並設定開機自動啟動
為了將一些應用程式給外部使用，因此要安裝 Cloudflare Tunnel，此篇是透過 Docker 配置 Cloudflare Tunnel，以下為操作步驟：

### 執行 Docker 命令啟用 Cloudflare Tunnel
```bash
sudo docker run --restart always cloudflare/cloudflared:latest tunnel --no-autoupdate run --token {{your-token}} --name cloudflared-tunnel
```

### 建立開機啟動設定檔
編輯檔案 `/etc/systemd/system/cloudflared.service`：
```bash
[Unit]
Description=Cloudflared Tunnel Service
After=network.target

[Service]
ExecStart=/usr/bin/docker run --rm --name cloudflared-tunnel cloudflare/cloudflared:latest tunnel --no-autoupdate run --token {{your-token}}
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
```
啟用服務：
```bash
sudo systemctl enable cloudflared.service
sudo systemctl start cloudflared.service
```
## 將一些Windows server script 轉成 linux bash 腳本
就算不熟Linux 指令，透過chatgpt 幫你轉換，其實蠻快速的。

## 心得

逐步將 Windows 替換為 Linux 的過程，不僅提高了系統穩定性與效能，這個過程也對Linux 更為熟悉。


## 補充 - Ubuntu 額外的小工具
燒機工具
```
sudo apt install stress-ng
#!/bin/bash

DURATION="120s"

echo "壓力測試開始...."

#CPU 壓力測試: 使用 4個CPU 核心

echo"CPU壓力測試.."

stress-ng --cpu 4  --cpu-load 100 --timeout $DURATION

# 記憶體壓力測試：創建 10 個進程，每個分配 180M 記憶體
echo "記憶體壓力測試..."
stress-ng --vm 20 --vm-bytes 500M --vm-keep --timeout $DURATION

# 磁碟 I/O 壓力測試：創建 5 個進程，每個進程寫入 10G 數據
echo "磁碟 I/O 壓力測試..."
stress-ng --hdd 10  --hdd-bytes 20G --timeout $DURATION

echo "壓力測試完成。"
```

監測工具
```
sudo apt install stress-ng
sudo apt install s-tui
```

---

## 關於本文與作者

本文出自 [Mark Ku's Blog](https://blog.markkulab.net/post/migrate-windows-to-linux-development-environment)

授權條款： [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — 轉載或引用請註明作者並附上原文連結

### 關於作者

**[Mark Ku](https://blog.markkulab.net/author/mark-ku)** — Software Solution Provider

- 10+ 年資深軟體工程師，現為 AI 應用 Builder
- 專注大型平台架構設計，從北美電商到AI SaaS訂閱收費系統
- 結合 AI Agent 與自動化，打造高效可演進的產品技術基礎

### 作者開發的免費工具

以下工具皆可免費使用：

- [免費 PDF 簽名工具](https://blog.markkulab.net/tools/pdf-sign): 線上 PDF 簽名工具，瀏覽器內完成手繪、打字、上傳簽名，可拖曳放置、縮放、下載。所有處理都在你的裝置完成，檔案不會上傳。
- [VS Code Refactory](https://blog.markkulab.net/tools/refactory): Refactory 是一款 VS Code 重構擴充套件：34 個重構動作、37 條 code smell 檢查、Code Health 儀表板、18 種語言、534 支測試。懂你的專案慣例：介面放哪、DI 註冊寫在哪、'use client' 該不該加；還會用 git 修改頻率 × 複雜度排出「該先修哪個檔案」，並一鍵把壞味道交給你自己電腦上的 Claude Code 修。免費使用，原始碼不離開你的機器。
- [DB-Kit 資料庫管理工具](https://blog.markkulab.net/tools/db-kit): DB-Kit 是一個用 Tauri + Rust + React 打造的輕量跨平台資料庫管理工具，用單一一致的介面同時管理 MySQL、MariaDB、PostgreSQL、SQL Server、Oracle、SQLite、MongoDB、Redis、Kafka、Elasticsearch 與 RabbitMQ 十一種資料來源：連線密碼以 OS keychain 加密、SSH Tunnel、完整 CRUD、視覺化查詢建構器、多結果集同時顯示、跨連線資料傳輸與比對同步、Excel / CSV 匯入匯出、執行計畫視覺化、ER 圖、排程備份、SQL 壓力測試（p50～p99 延遲百分位）、15 條規則的 SQL 審查、Kafka 訊息瀏覽與監控告警；繁中 / 英文雙語介面，內建 AI 助手（自然語言生成 SQL、AI 審查與調校建議）與命令列工具 dbk。免費開源（MIT），提供 Windows / macOS / Linux 安裝檔。
- [VS Code Super Mermaid](https://blog.markkulab.net/tools/super-mermaid): Super Mermaid 是一款 VS Code 擴充套件：開箱即用的漂亮 Mermaid 圖表，自動上色、即時預覽、滑鼠平移縮放、PNG / SVG 高解析匯出，內建 21 種範本與多種主題。免費開源（MIT）。
- [React Super Mermaid](https://blog.markkulab.net/tools/react-super-mermaid): react-super-mermaid 是一個開源 React 元件庫：一行 <MermaidViewer> 即可渲染漂亮的 Mermaid 圖表，內建 colorful / sketch 主題、平移縮放、圖內搜尋、SVG / PNG 高解析匯出。輕量、SSR 安全、完整 TypeScript 型別。免費開源（MIT）。
- [Jira / Confluence Super Mermaid](https://blog.markkulab.net/tools/jira-super-mermaid): Atlassian Forge app：在 Jira issue 與 Confluence 內文直接寫 Mermaid 語法，畫流程圖、時序圖、狀態機與甘特圖。11 種圖表、SVG / PNG 匯出、明暗主題、完整中日韓文字支援。取得 Runs on Atlassian 資格：圖表存在你自己的站台，app 不呼叫任何第三方服務。免費，即將上架 Atlassian Marketplace。
- [Mermaid 線上預覽](https://blog.markkulab.net/tools/mermaid-preview): 在瀏覽器裡寫 Mermaid、即時看圖，整張圖表壓進網址就能分享。免註冊、不上傳伺服器，相容 mermaid.live 的分享連結。
- [React Intl Phone Number](https://blog.markkulab.net/tools/react-intl-phone-number): react-intl-phone-number 是一個開源 React 元件：framework-agnostic、不依賴 antd，提供 E.164 進出、可搜尋國旗 / 國碼下拉、可配置驗證等級（strict / mobile-strict / loose）、可主題化 CSS 與 i18n，電話邏輯由 google-libphonenumber 驅動。輕量、完整 TypeScript 型別。免費開源（MIT）。
- [Uptime Kuma Cluster](https://blog.markkulab.net/tools/uptime-kuma-cluster): 把單機版 Uptime Kuma 改造成高可用叢集：OpenResty + Lua 智慧負載平衡、MariaDB 共享狀態、健康檢查與自動 Failover，附叢集管理 REST API，一行 Docker Compose 啟動。免費開源（MIT）。
- [特教專案](https://blog.markkulab.net/education): 為特殊教育學生製作的學習教材

### 每日 Podcast

- [科技新鮮事](https://blog.markkulab.net/category/tech-news): 每日精選 AI 與科技趨勢，透過語音摘要快速掌握最新技術動態，涵蓋 AI 應用、軟體架構、DevOps 與工程實戰。 — RSS: https://blog.markkulab.net/feed.xml
- [AI股市蝦聊](https://blog.markkulab.net/category/ai-stock-chat): 每個交易日用 AI 分析台股盤勢，以雙人對話聊當天的盤中觀察與隔日預測。 — RSS: https://blog.markkulab.net/ai-stock-chat/feed.xml

### 電子報

[訂閱電子報](https://blog.markkulab.net/subscribe) — 第一時間收到新文章通知，無垃圾信、隨時可取消訂閱。