服务器环境配置指南
每次拿到一台没有 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 备齐:
# 下载 micromamba 二进制(详见下一节)curl -Ls https://micro.mamba.pm/api/micromamba/linux-64/latest | tar -xvj .local/micromambachmod +x .local/micromamba/micromamba
# 创建一个用于编译的环境./.local/micromamba/micromamba create -n make make ncurses1.2 下载并解压 zsh 源码
把 zsh 5.9.1 的源码包拉下来解压进目录:
# 下载 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.xztar -xJf zsh-5.9.1.tar.xzcd zsh-5.9.11.3 配置与编译
关键一步是把刚才 micromamba 环境里的 ncurses 头文件和库路径喂给编译器,同时加上 -Wl,-rpath 确保运行时也能找到动态库:
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 切过去:
# 确认 zsh 路径which zsh# 查看当前系统已登记的 shellcat /etc/shells
# 切换默认登录 shellchsh -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
直接用官方脚本一键安装:
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"脚本会自动备份原有的 ~/.zshrc,再生成一份新的默认配置,不用担心把旧配置覆盖没了。
1.5.2 安装 Powerlevel10k 主题
把 p10k 浅克隆到 oh-my-zsh 的自定义主题目录:
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:
# 修改前ZSH_THEME="robbyrussell"
# 修改后ZSH_THEME="powerlevel10k/powerlevel10k"1.5.4 过一遍配置向导
重新加载 ~/.zshrc 或者新开一个终端标签页,p10k 会自动弹出交互式配置向导:
source ~/.zshrc向导会一步步让你选自己喜欢的样子:
- 字体:是否安装 Meslo Nerd Font(推荐安装,否则部分图标显示异常)
- 样式:经典、纯净、彩虹、瘦线等多种样式可选
- 提示符元素:选择要显示的信息(时间、电池、Python 虚拟环境、git 状态等)
- 间距与换行:单行或双行提示符
选完会自动生成 ~/.p10k.zsh。以后想换风格,随时执行 p10k configure 就能重新走一遍向导。
TIP如果终端连接后图标显示为乱码或方框,说明缺少 Nerd Font。可以在本地终端(如 iTerm2、Windows Terminal)中下载安装 Meslo Nerd Font,并将终端字体设置为
MesloLGS NF。
TIPp10k 配置向导提供了丰富的自定义选项,强烈建议首次使用时花几分钟过一遍向导,后续使用体验会好很多。
2. 部署 Micromamba
相比传统 conda,micromamba 是用 C++ 重写的静态链接版本,启动飞快,还没有恼人的环境嵌套问题,在无 root 权限的服务器上用来管 Python 环境特别趁手。
2.1 下载与安装
如果前面编译 zsh 时还没下载,这里直接拉一份最新二进制放到 .local/micromamba:
curl -Ls https://micro.mamba.pm/api/micromamba/linux-64/latest | tar -xvj .local/micromambachmod +x .local/micromamba/micromamba2.2 初始化 Shell
按你实际使用的 Shell 选对应的初始化命令:
./.local/micromamba/micromamba shell init -s bash# 如果使用 zsh,替换为:./.local/micromamba/micromamba shell init -s zsh跑完之后 source 一下配置文件或者重新登录,micromamba 命令就可以直接用了。
2.3 验证安装
敲一句环境列表看看反馈:
micromamba env list只要能正常打印出环境列表(哪怕里面还是空的),就说明部署没问题了。
3. 规划目录结构
3.1 先摸清服务器家底
一上来别急着往家目录里猛塞大文件。我习惯先跑三条命令摸一下磁盘挂载、用户配额和所属用户组:
df -h # 查看磁盘挂载与容量quota -v # 查看用户配额groups # 查看所属组3.2 建立个人工作目录
摸清共享存储的位置后,建议先按用途把个人目录规整好。
这样做的目的是将自己的文件(代码、数据、模型、产出)存放在干净的独立目录中,与
~/.cache、shell 配置文件、micromamba 环境等系统/工具生成的文件彻底分离。这样无论是备份、迁移还是清理缓存,都不会误伤自己的数据。
我常用的目录划分长这样:
/share/<group_name>/<username>/├── Datasets/ # 数据集├── Models/ # 预训练模型├── Outputs/ # 输出与实验结果└── Projects/ # 项目工作区直接一条命令建出来(记得把 your-group 换成你的实际组名):
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 建一个日常项目工作区
顺手在本地家目录下也建好项目工作区:
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 连通性验一遍:
command -v "$HOME/bin/rclone"command -v fusermount3ssh -i "$HOME/.ssh/id_ed25519" localhost true定义脱敏路径变量
先把源目录和挂载点收进环境变量:
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"动手挂载前,先确认源目录确实存在,再把挂载点建出来并确保里面是空的:
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 1fi执行挂载
这里有个小细节:rclone 的按需 SFTP remote 需要用双斜杠 // 来表示远端绝对路径。所以下面先剥掉 SOURCE_DIR 开头的 /,再手动拼上 //:
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,千万别直接照搬这个选项。
挂完跑两条命令确认一下状态:
mountpoint "$MOUNT_DIR"findmnt -T "$MOUNT_DIR"确认无误后,读写 Pan/w1 背后实际就会通过本机 SFTP 直接落到 ai-workspace/w1。
需要时怎么卸载
正常卸载直接用 fusermount3:
fusermount3 -u "$MOUNT_DIR"如果提示设备忙,先查一下是不是有终端、编辑器或者训练脚本正占着这个目录,把它们退掉再卸。实在腾不出来时,也可以用延迟卸载:
fusermount3 -uz "$MOUNT_DIR"WARNING挂载期间不要删除或移动
w1挂载点。服务器重启后 FUSE 挂载会失效,需要重新执行挂载命令;若要长期使用,可以后续再封装为登录脚本或用户级服务。
4. 创建 Python 环境
4.1 先建一个基础 Python 3.10 环境
工具链都就位后,建一个日常通用的 Python 3.10 环境打底:
micromamba create -n py10 python=3.104.2 顺手记一下常用管理命令
平时切环境、装包、清环境基本就这几句:
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:
mkdir -p ~/.config/pipcat > ~/.config/pip/pip.conf <<'EOF'[global]index-url = https://pypi.tuna.tsinghua.edu.cn/simpletrusted-host = pypi.tuna.tsinghua.edu.cnEOF5.2 验证一下是否生效
用刚建好的 py10 环境查一遍 pip 配置:
micromamba run -n py10 python -m pip config list输出里能看到 index-url 已经指向清华源,就搞定了。
6. 顺手理一下启动配置文件
整套折腾下来,容易乱的地方往往是几个 Shell 启动文件。为了保证每次重新登录环境都能正常拉起,这里把它们各自的职责列出来对照一下:
| 文件 | 用途 |
|---|---|
~/.bashrc | bash 交互式 shell 的配置文件 |
~/.bash_profile | bash 登录时读取的配置文件 |
~/.zshrc | zsh 的配置文件 |
建议把 micromamba 的初始化脚本,以及 PATH、LD_LIBRARY_PATH 这类环境变量统一收拢到你实际使用的 Shell 配置文件里,后续排查会轻松很多。
7. 配一个 Git 提交模板
在服务器上写实验代码时,提交一多很容易只写个模糊的 commit message,过两天自己都忘了改了啥。给 Git 配一个结构化的提交模板,每次 git commit 都会自动带上提示,省得漏记上下文。
7.1 创建模板文件
把下面这个三段式模板写进 ~/.git-commit-template.txt:
cat > ~/.git-commit-template.txt << 'EOF'
**note:**-
---**todo:**- []---**fixed:**- []
EOF三个区块各自负责一块信息:
| 区域 | 用途 |
|---|---|
**note:** | 备注说明、背景信息、相关上下文 |
**todo:** | 待完成的待办项,使用 - [] 标记 |
**fixed:** | 本次提交修复的问题或完成的事项 |
7.2 让 Git 启用这份模板
执行下面这句设为全局默认:
git config --global commit.template ~/.git-commit-template.txtTIP如果希望只对特定项目生效,去掉
--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 三段式)
这几项全绿之后,这台新服务器基本就可以直接投入干活——下数据集、拉模型、跑实验脚本都会顺手很多。以后升级工具时也记得继续坚持放在用户目录下,别和系统包管理器混着用,省得惹出版本冲突。