3287 字
16 分钟

服务器环境配置指南

每次拿到一台没有 root 权限的新 Linux 服务器,最头疼的就是从零把趁手的工具链搬上去,又不想动不动去找管理员帮忙装软件。折腾过几次之后,我把整套「用户态开荒流程」整理了下来,全程只在自己家目录下动手,完全不碰 sudo。

这套流程涵盖我平时上线新机器最常用的几件事:

  • Shell 环境初始化与用户态 zsh 编译安装
  • oh-my-zsh 配置与 Powerlevel10k 主题
  • micromamba 部署与初始化
  • 个人共享目录与项目工作区规划
  • 用 rclone 把本机 SFTP 目录挂载成普通 FUSE 目录
  • Python 环境创建
  • pip 国内镜像配置

再强调一句,下面每一步都不需要 sudo 或 root 权限,放心在用户目录下照着跑就行。


1. 给 Shell 升个级:用户态编译安装 zsh#

大多数 Linux 服务器默认只给了 bash,但如果你平时习惯了 zsh 的补全和主题生态,花几分钟自己编译一份用户态 zsh 绝对值回票价。

1.1 准备编译依赖#

没有 root 权限没法直接 apt 或 yum 装依赖,这里取个巧:先拉一个独立的 micromamba 二进制,建个临时的 make 环境把 make 和 ncurses 备齐:

Terminal window
# 下载 micromamba 二进制(详见下一节)
curl -Ls https://micro.mamba.pm/api/micromamba/linux-64/latest | tar -xvj .local/micromamba
chmod +x .local/micromamba/micromamba
# 创建一个用于编译的环境
./.local/micromamba/micromamba create -n make make ncurses

1.2 下载并解压 zsh 源码#

把 zsh 5.9.1 的源码包拉下来解压进目录:

Terminal window
# 下载 zsh 源码包
wget https://sourceforge.net/projects/zsh/files/zsh/5.9.1/zsh-5.9.1.tar.xz/download -O zsh-5.9.1.tar.xz
tar -xJf zsh-5.9.1.tar.xz
cd zsh-5.9.1

1.3 配置与编译#

关键一步是把刚才 micromamba 环境里的 ncurses 头文件和库路径喂给编译器,同时加上 -Wl,-rpath 确保运行时也能找到动态库:

Terminal window
ENV_PATH="$HOME/.local/micromamba/envs/make"
make distclean || rm -f config.cache
./configure --prefix="$HOME/.local/zsh" \
CFLAGS="-I${ENV_PATH}/include -I${ENV_PATH}/include/ncurses" \
CPPFLAGS="-I${ENV_PATH}/include -I${ENV_PATH}/include/ncurses" \
LDFLAGS="-L${ENV_PATH}/lib -Wl,-rpath,${ENV_PATH}/lib" \
--with-termlib=ncurses
make && make install

编译跑完,zsh 就稳稳装进 $HOME/.local/zsh 了。

1.4 切换默认 Shell#

把路径加进 PATH 确认能找到之后,试着用 chsh 把默认登录 Shell 切过去:

~/.local/zsh/bin/zsh
# 确认 zsh 路径
which zsh
# 查看当前系统已登记的 shell
cat /etc/shells
# 切换默认登录 shell
chsh -s "$HOME/.local/zsh/bin/zsh"
TIP

如果 chsh 在服务器上可用(部分共享服务器允许用户自行切换),该命令会直接生效。重新登录后即为 zsh。

若 chsh 不可用,可在 ~/.bash_profile 末尾添加 exec $HOME/.local/zsh/bin/zsh,每次登录时自动进入 zsh。

1.5 装上 oh-my-zsh 和 Powerlevel10k 主题#

有了 zsh,顺手把 oh-my-zsh 和 Powerlevel10k(简称 p10k)配齐。oh-my-zsh 的插件和主题生态非常省心,而 p10k 响应极快,信息展示直观,交互式配置向导也很好上手。

1.5.1 安装 oh-my-zsh#

直接用官方脚本一键安装:

Terminal window
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

脚本会自动备份原有的 ~/.zshrc,再生成一份新的默认配置,不用担心把旧配置覆盖没了。

1.5.2 安装 Powerlevel10k 主题#

把 p10k 浅克隆到 oh-my-zsh 的自定义主题目录:

Terminal window
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"

1.5.3 启用主题#

打开 ~/.zshrc,把默认的主题改成 powerlevel10k/powerlevel10k:

Terminal window
# 修改前
ZSH_THEME="robbyrussell"
# 修改后
ZSH_THEME="powerlevel10k/powerlevel10k"

1.5.4 过一遍配置向导#

重新加载 ~/.zshrc 或者新开一个终端标签页,p10k 会自动弹出交互式配置向导:

Terminal window
source ~/.zshrc

向导会一步步让你选自己喜欢的样子:

  • 字体:是否安装 Meslo Nerd Font(推荐安装,否则部分图标显示异常)
  • 样式:经典、纯净、彩虹、瘦线等多种样式可选
  • 提示符元素:选择要显示的信息(时间、电池、Python 虚拟环境、git 状态等)
  • 间距与换行:单行或双行提示符

选完会自动生成 ~/.p10k.zsh。以后想换风格,随时执行 p10k configure 就能重新走一遍向导。

TIP

如果终端连接后图标显示为乱码或方框,说明缺少 Nerd Font。可以在本地终端(如 iTerm2、Windows Terminal)中下载安装 Meslo Nerd Font,并将终端字体设置为 MesloLGS NF。

TIP

p10k 配置向导提供了丰富的自定义选项,强烈建议首次使用时花几分钟过一遍向导,后续使用体验会好很多。


2. 部署 Micromamba#

相比传统 conda,micromamba 是用 C++ 重写的静态链接版本,启动飞快,还没有恼人的环境嵌套问题,在无 root 权限的服务器上用来管 Python 环境特别趁手。

2.1 下载与安装#

如果前面编译 zsh 时还没下载,这里直接拉一份最新二进制放到 .local/micromamba:

Terminal window
curl -Ls https://micro.mamba.pm/api/micromamba/linux-64/latest | tar -xvj .local/micromamba
chmod +x .local/micromamba/micromamba

2.2 初始化 Shell#

按你实际使用的 Shell 选对应的初始化命令:

Terminal window
./.local/micromamba/micromamba shell init -s bash
# 如果使用 zsh,替换为:
./.local/micromamba/micromamba shell init -s zsh

跑完之后 source 一下配置文件或者重新登录,micromamba 命令就可以直接用了。

2.3 验证安装#

敲一句环境列表看看反馈:

Terminal window
micromamba env list

只要能正常打印出环境列表(哪怕里面还是空的),就说明部署没问题了。


3. 规划目录结构#

3.1 先摸清服务器家底#

一上来别急着往家目录里猛塞大文件。我习惯先跑三条命令摸一下磁盘挂载、用户配额和所属用户组:

Terminal window
df -h # 查看磁盘挂载与容量
quota -v # 查看用户配额
groups # 查看所属组

3.2 建立个人工作目录#

摸清共享存储的位置后,建议先按用途把个人目录规整好。

这样做的目的是将自己的文件(代码、数据、模型、产出)存放在干净的独立目录中,与 ~/.cache、shell 配置文件、micromamba 环境等系统/工具生成的文件彻底分离。这样无论是备份、迁移还是清理缓存,都不会误伤自己的数据。

我常用的目录划分长这样:

/share/<group_name>/<username>/
├── Datasets/ # 数据集
├── Models/ # 预训练模型
├── Outputs/ # 输出与实验结果
└── Projects/ # 项目工作区

直接一条命令建出来(记得把 your-group 换成你的实际组名):

Terminal window
GROUP_NAME="your-group"
USER_NAME="${USER:?当前 shell 未设置 USER}"
SHARE_BASE="/share/${GROUP_NAME}/${USER_NAME}"
mkdir -p "${SHARE_BASE}"/{Datasets,Models,Outputs,Projects}

3.3 建一个日常项目工作区#

顺手在本地家目录下也建好项目工作区:

Terminal window
mkdir -p ~/Projects/work1

平时可以把本地工作区和共享目录配合着用,比如把大的实验产出软链接或者直接落到共享目录里,方便和同组的人协作。

3.4 用 rclone 把本机 SFTP 目录挂载为普通目录#

有时候会碰到比较挑剔的程序:它要么不认符号链接,要么硬性要求目标路径必须是一个普通目录。我遇到过这个坑,最后的解法是用 rclone 通过本机的 SSH/SFTP 去读实际工作目录,再把它挂载成另一个路径下的普通 FUSE 目录——这样对上层程序来说它就是一个实打实的普通文件夹,不再是软链接。

我这么折腾的主要目的,是把想通过网页浏览的内容统一挂到一个固定目录里,再交给 OpenList 这类外部服务对外提供网页访问,既不用搬家也不用多复制一份文件。

下面假设服务器上的目录结构是这样的:

/sdc/home/<username>/<username>/
├── ai-workspace/w1/ # 实际目录
└── Pan/w1/ # FUSE 挂载点

示例里统一从 $USER 拿用户名,避免把真实账号写死在命令或文档里。

先检查前置条件#

这个方案同样不需要 root 权限,但得先确认这几项条件都满足:

  • $HOME/bin/rclone 已安装且可执行;
  • 系统提供 fusermount3;
  • 本机 sshd 正在运行;
  • ~/.ssh/id_ed25519 可以免密登录 localhost;
  • 挂载点目录存在且是空的。

先跑三条命令把依赖和本机 SSH 连通性验一遍:

Terminal window
command -v "$HOME/bin/rclone"
command -v fusermount3
ssh -i "$HOME/.ssh/id_ed25519" localhost true

定义脱敏路径变量#

先把源目录和挂载点收进环境变量:

Terminal window
USER_NAME="${USER:?当前 shell 未设置 USER}"
USER_ROOT="/sdc/home/${USER_NAME}/${USER_NAME}"
SOURCE_DIR="${USER_ROOT}/ai-workspace/w1"
MOUNT_DIR="${USER_ROOT}/Pan/w1"

动手挂载前,先确认源目录确实存在,再把挂载点建出来并确保里面是空的:

Terminal window
test -d "$SOURCE_DIR"
mkdir -p "$MOUNT_DIR"
if [ -n "$(find "$MOUNT_DIR" -mindepth 1 -maxdepth 1 -print -quit)" ]; then
echo "挂载点非空:$MOUNT_DIR" >&2
exit 1
fi

执行挂载#

这里有个小细节:rclone 的按需 SFTP remote 需要用双斜杠 // 来表示远端绝对路径。所以下面先剥掉 SOURCE_DIR 开头的 /,再手动拼上 //:

Terminal window
REMOTE=":sftp,host=localhost,user=${USER_NAME},key_file=${HOME}/.ssh/id_ed25519,known_hosts_file=none://${SOURCE_DIR#/}"
LOG_FILE="$(dirname "$MOUNT_DIR")/.rclone-w1.log"
"$HOME/bin/rclone" mount "$REMOTE" "$MOUNT_DIR" \
--daemon \
--vfs-cache-mode writes \
--log-file "$LOG_FILE" \
--log-level INFO

注意这里的 known_hosts_file=none 会跳过 localhost 的主机密钥校验,只适合明确连本机回环 SSH 的场景;如果哪天你要拿它连别的机器,一定要老老实实配好并校验 known_hosts,千万别直接照搬这个选项。

挂完跑两条命令确认一下状态:

Terminal window
mountpoint "$MOUNT_DIR"
findmnt -T "$MOUNT_DIR"

确认无误后,读写 Pan/w1 背后实际就会通过本机 SFTP 直接落到 ai-workspace/w1。

需要时怎么卸载#

正常卸载直接用 fusermount3:

Terminal window
fusermount3 -u "$MOUNT_DIR"

如果提示设备忙,先查一下是不是有终端、编辑器或者训练脚本正占着这个目录,把它们退掉再卸。实在腾不出来时,也可以用延迟卸载:

Terminal window
fusermount3 -uz "$MOUNT_DIR"
WARNING

挂载期间不要删除或移动 w1 挂载点。服务器重启后 FUSE 挂载会失效,需要重新执行挂载命令;若要长期使用,可以后续再封装为登录脚本或用户级服务。


4. 创建 Python 环境#

4.1 先建一个基础 Python 3.10 环境#

工具链都就位后,建一个日常通用的 Python 3.10 环境打底:

Terminal window
micromamba create -n py10 python=3.10

4.2 顺手记一下常用管理命令#

平时切环境、装包、清环境基本就这几句:

Terminal window
micromamba env list # 列出所有环境
micromamba activate py10 # 激活环境
micromamba deactivate # 退出当前环境
micromamba remove -n py10 --all # 删除环境
micromamba install -n py10 <package> # 安装包

5. 给 pip 配上国内镜像#

在国内网络环境下,不换源装个大一点的包能等到怀疑人生,顺手把清华源配上是刚需。

5.1 写入配置文件#

直接把配置落盘到 ~/.config/pip/pip.conf:

Terminal window
mkdir -p ~/.config/pip
cat > ~/.config/pip/pip.conf <<'EOF'
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF

5.2 验证一下是否生效#

用刚建好的 py10 环境查一遍 pip 配置:

Terminal window
micromamba run -n py10 python -m pip config list

输出里能看到 index-url 已经指向清华源,就搞定了。


6. 顺手理一下启动配置文件#

整套折腾下来,容易乱的地方往往是几个 Shell 启动文件。为了保证每次重新登录环境都能正常拉起,这里把它们各自的职责列出来对照一下:

文件用途
~/.bashrcbash 交互式 shell 的配置文件
~/.bash_profilebash 登录时读取的配置文件
~/.zshrczsh 的配置文件

建议把 micromamba 的初始化脚本,以及 PATH、LD_LIBRARY_PATH 这类环境变量统一收拢到你实际使用的 Shell 配置文件里,后续排查会轻松很多。


7. 配一个 Git 提交模板#

在服务器上写实验代码时,提交一多很容易只写个模糊的 commit message,过两天自己都忘了改了啥。给 Git 配一个结构化的提交模板,每次 git commit 都会自动带上提示,省得漏记上下文。

7.1 创建模板文件#

把下面这个三段式模板写进 ~/.git-commit-template.txt:

Terminal window
cat > ~/.git-commit-template.txt << 'EOF'
**note:**
-
---
**todo:**
- []
---
**fixed:**
- []
EOF

三个区块各自负责一块信息:

区域用途
**note:**备注说明、背景信息、相关上下文
**todo:**待完成的待办项,使用 - [] 标记
**fixed:**本次提交修复的问题或完成的事项

7.2 让 Git 启用这份模板#

执行下面这句设为全局默认:

Terminal window
git config --global commit.template ~/.git-commit-template.txt
TIP

如果希望只对特定项目生效,去掉 --global,在对应仓库目录下执行 git config commit.template ~/.git-commit-template.txt 即可。

7.3 实际提交时的效果#

配好以后,只要执行不带 -m 的 git commit,编辑器就会自动把模板填好等你写:

**note:**
-
---
**todo:**
- []
---
**fixed:**
- []

按区块往里填就行。如果只是随手做个简单提交,直接用 git commit -m 依然会跳过模板,不影响效率。


跑完收尾检查#

整套环境搭完后,我通常会按下面这份清单快速过一遍,确认没有漏项:

  • 用户态 micromamba 已安装,可管理 Python 环境
  • zsh 已编译安装并设为默认登录 shell
  • 个人共享目录与标准子目录结构已建立
  • 项目工作区已创建
  • Python 3.10 环境(py10)已创建
  • pip 已配置清华镜像源
  • Git 提交模板已配置(note/todo/fixed 三段式)

这几项全绿之后,这台新服务器基本就可以直接投入干活——下数据集、拉模型、跑实验脚本都会顺手很多。以后升级工具时也记得继续坚持放在用户目录下,别和系统包管理器混着用,省得惹出版本冲突。

服务器环境配置指南
https://pinellia.uk/posts/server-env-setup/
作者
Pinellia
发布于
2026-06-12
许可协议
CC BY-NC-SA 4.0