Linux 基础配置与终端环境

在将原有 Linux 虚拟机 / 物理设备的工作流与软件迁移至 WSL2 (Windows Subsystem for Linux) 环境时，建立一个稳定、高性能且安全的底层系统环境与终端配置是后续所有开发与服务部署的基础。

本文档记录从零初始化 WSL2（Ubuntu 24.04 LTS）、内核与宿主交互调优、APT 镜像源配置、现代 Zsh 终端增强，以及敏感环境变量分层隔离的完整实践。

---

1. 架构拓扑与配置分层

在 WSL2 架构下，宿主机 Windows 与 Linux 容器化虚拟机深度协同。为了兼顾便携性与安全性，所有系统配置与用户凭据遵循公开与私有分层原则：

---

2. WSL2 系统级配置调优

2.1 Windows 宿主全局配置 (.wslconfig)

在 Windows 用户家目录（%USERPROFILE%\.wslconfig，例如 C:\Users\<UserName>\.wslconfig）中创建或编辑配置文件，调优资源分配与网络行为：

[wsl2]
# 限制 WSL2 最大内存使用量（按宿主机总内存合理分配）
memory=8GB

# 限制 CPU 核心数
processors=4

# 交换空间大小
swap=4GB

# 启用宿主与 WSL 间的 localhost 端口转发
localhostForwarding=true

# [可选] 启用 WSLg 图形化支持
guiApplications=true

提示：修改 .wslconfig 后，需在 Windows PowerShell 中执行 wsl --shutdown 重启 WSL 实例生效。

---

2.2 WSL 实例内部配置 (/etc/wsl.conf)

进入 WSL 发行版，编辑 /etc/wsl.conf 配置系统启动参数与挂载行为：

[boot]
# 启用 systemd 初始化守护进程（Ubuntu 24.04 推荐开启，支持 systemctl）
systemd=true

[user]
# 指定默认登录用户（替换为实际用户名）
default=${WSL_USER}

[interop]
# 允许从 WSL 启动 Windows 二进制程序
enabled=true
# 将 Windows PATH 环境变量追加到 Linux PATH 中
appendWindowsPath=true

[automount]
# 自动挂载 Windows 盘符
enabled=true
mountFsTab=true
root=/mnt/
options="metadata,umask=22,fmask=11"

---

2.3 APT 软件源配置 (Ubuntu 24.04 Noble)

Ubuntu 24.04 采用了 deb822 格式管理软件源（文件位于 /etc/apt/sources.list.d/ubuntu.sources）。为提升国内访问与依赖下载速度，可配置镜像源（如清华大学镜像源）：

# 1. 备份默认源配置
sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak

# 2. 替换为清华大学开源镜像源
sudo tee /etc/apt/sources.list.d/ubuntu.sources << 'EOF'
Types: deb
URIs: https://mirrors.tuna.tsinghua.edu.cn/ubuntu/
Suites: noble noble-updates noble-backports
Components: main universe restricted multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

Types: deb
URIs: https://mirrors.tuna.tsinghua.edu.cn/ubuntu/
Suites: noble-security
Components: main universe restricted multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
EOF

# 3. 更新软件包索引并安装基础工具链
sudo apt update && sudo apt upgrade -y
sudo apt install -y \
    build-essential \
    curl \
    wget \
    git \
    zsh \
    ca-certificates \
    gnupg \
    lsb-release \
    jq \
    unzip \
    htop \
    tree

---

3. Zsh 终端与 Oh My Zsh 现代化配置

3.1 安装与切换默认 Shell

# 确认 zsh 安装路径
which zsh

# 将当前用户的默认 Shell 切换为 zsh
chsh -s $(which zsh)

---

3.2 安装 Oh My Zsh 与增强插件

使用国内镜像或官方源安装 Oh My Zsh：

# 安装 Oh My Zsh (通过镜像快速安装)
sh -c "$(curl -fsSL https://gitee.com/mirrors/oh-my-zsh/raw/master/tools/install.sh)"

# 下载常用增强插件：
# 1. 历史命令自动补全建议 (zsh-autosuggestions)
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

# 2. 语法高亮 (zsh-syntax-highlighting)
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

# 3. 智能目录快速跳转 (zoxide)
curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh

---

3.3 通用 ~/.zshrc 配置文件规范

以下是推荐的 ~/.zshrc 核心模板。该配置可安全纳入 Git 版本控制：

# -------------------------------------------------------------
# 1. Oh My Zsh 基础路径与主题设置
# -------------------------------------------------------------
export ZSH="$HOME/.oh-my-zsh"
ZSH_THEME="robbyrussell" # 或使用 starship / powerlevel10k

# -------------------------------------------------------------
# 2. 插件加载列表
# -------------------------------------------------------------
plugins=(
    git
    sudo
    extract
    zsh-autosuggestions
    zsh-syntax-highlighting
)

source $ZSH/oh-my-zsh.sh

# -------------------------------------------------------------
# 3. 基础环境变量与 PATH 扩展
# -------------------------------------------------------------
export LANG="en_US.UTF-8"
export LC_ALL="en_US.UTF-8"
export EDITOR="vim"

# 本地二进制目录
export PATH="$HOME/.local/bin:$HOME/bin:$PATH"

# -------------------------------------------------------------
# 4. WSL 宿主互通与常用别名 (Aliases)
# -------------------------------------------------------------
alias ll='ls -alF'
alias la='ls -A'
alias l='ls -CF'
alias cls='clear'

# 快速切换至 Windows 宿主用户目录
alias cdwin='cd /mnt/c/Users/${WIN_USER}'
alias cddesk='cd /mnt/c/Users/${WIN_USER}/Desktop'

# WSL 默认启动时回到 Linux 家目录（避免停留在 Windows 挂载盘导致性能损耗）
if [ "$PWD" = "/mnt/c/Users/${WIN_USER}" ]; then
    cd ~
fi

# -------------------------------------------------------------
# 5. 网络代理辅助函数 (WSL 宿主机代理穿透)
# -------------------------------------------------------------
function setproxy() {
    local host_ip
    # 动态获取宿主机 IP 地址
    host_ip=$(ip route | grep default | awk '{print $3}')
    local proxy_port=${PROXY_PORT:-7890}
    
    export http_proxy="http://${host_ip}:${proxy_port}"
    export https_proxy="http://${host_ip}:${proxy_port}"
    export all_proxy="socks5://${host_ip}:${proxy_port}"
    echo "⚡ Proxy set to http://${host_ip}:${proxy_port}"
}

function unsetproxy() {
    unset http_proxy https_proxy all_proxy
    echo "🚫 Proxy disabled"
}

function checkproxy() {
    echo "http_proxy  = ${http_proxy:-[unset]}"
    echo "https_proxy = ${https_proxy:-[unset]}"
    echo "Testing connection to Google..."
    curl -I -s --connect-timeout 3 https://www.google.com | head -n 1 || echo "❌ Connection failed"
}

# -------------------------------------------------------------
# 6. 【核心安全机制】动态加载本地私有敏感配置
# -------------------------------------------------------------
if [ -f "$HOME/.zshrc.local" ]; then
    source "$HOME/.zshrc.local"
fi

---

4. 敏感信息与环境变量安全隔离规范

在软件迁移与多设备开发过程中，经常会涉及各平台 API Key、数据库密码、私有 Git Token 及服务器部署凭据。

4.1 隔离原则

1. 公开与私有物理分离：
   • ~/.zshrc：只存放通用的工具链别名、函数与公开配置，可公开分享与版本控制；
   • ~/.zshrc.local：存放敏感 Key、密码、企业内网地址、私有 Token 等，严禁提交至 Git。
2. 所有关键凭据一律变量化：
   • 脚本与代码中严禁出现明文 Secret，统一通过 export KEY_NAME="xxx" 注入环境变量。

---

4.2 本地私有配置文件模板 (~/.zshrc.local)

在本地创建 ~/.zshrc.local，并设置严格的文件权限：

# 创建并限制文件读取权限仅当前用户可读写
touch ~/.zshrc.local
chmod 600 ~/.zshrc.local

在 ~/.zshrc.local 中配置私有凭据（示例模板）：

# ~/.zshrc.local - 私有环境变量配置（本地保存，绝不外发）

# 1. 常用开发平台 API Keys
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 2. 代码托管平台 Access Tokens
export GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export GITLAB_TOKEN="glpat-xxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 3. 部署与服务器凭据
export DEPLOY_SERVER_IP="${DEPLOY_SERVER_IP:-192.168.1.100}"
export DEPLOY_AUTH_KEY="${DEPLOY_AUTH_KEY:-custom_secret_key}"

# 4. 私有代理端口定制（若与默认 7890 不同）
export PROXY_PORT="7890"

---

5. 跨平台互通与常见避坑要点

5.1 跨文件系统读写性能陷阱

• 高频 I/O 务必在 Linux 原生文件系统进行：将项目代码放在 ~/projects/ 或 /home/<user>/ 下编译；
• 避免在 /mnt/c/ 下执行 npm install、cargo build 或重型 Git 操作：由于 9P 文件系统协议开销，跨盘读写性能相较原生 ext4 慢 5~10 倍。

5.2 剪贴板双向互通

在 WSL2 中可通过 Windows 内置工具实现终端与宿主机剪贴板互通：

# 将输出内容复制到 Windows 剪贴板
echo "Hello from WSL" | clip.exe

# 或封装 alias：
alias pbcopy='clip.exe'

5.3 检查 WSL 运行状态与快速维护

# 在 Windows PowerShell 中查看 WSL 运行状态
wsl --status
wsl --list --verbose

# 彻底终止 WSL（释放内存）
wsl --shutdown