目录

ubuntu-env-setup

Ubuntu 开发环境一键搭建脚本。在新装的 Ubuntu 机器上,通过 gitlink(CCF 开源创新服务平台)快速拉取并配置 zsh + oh-my-zsh + tmux,并按需交互式切换 apt / conda / pip 到清华(TUNA)镜像源(默认不切换,自行选择)。

主要目标:方便自己快速重建环境。同时全部仓库公开,其他人也可直接受益。

仓库结构

ubuntu-env-setup/
├── bootstrap.sh          # 主安装脚本(交互式一键执行)
├── zshrc                 # 个人 zsh 配置(含自定义 PROMPT)
├── tmux.conf.local       # 个人 tmux 配置(gpakosz/.tmux 的上层覆盖)
├── .gitignore            # 忽略本地杂项,避免误传
└── LICENSE               # MIT 许可(第三方 fork 内容版权归原作者)

快速开始

在新 Ubuntu 机器上执行

git clone --depth 1 https://gitlink.org.cn/jixiaopeng/ubuntu-env-setup.git
cd ubuntu-env-setup
bash bootstrap.sh

脚本依赖同目录的 zshrc / tmux.conf.local 模板,git clone 整仓已包含,直接运行即可。不建议用单文件 curl 拉取(gitlink 无稳定 raw 直链,且会丢失模板)。

交互式配置

脚本运行时会在终端里逐步询问,全程回车即用默认值(apt=不换源,conda=不装):

是否将 apt 切换到清华源?(需要 sudo,会自动备份原源文件)[y/N]:

请选择 Python 环境管理方式:
  1) Miniconda(轻量,推荐,约 100MB)
  2) Anaconda(完整发行版,约 1GB,有商业条款)
  3) 不安装(默认)
请输入 [1/2/3,回车默认 3]:
  • apt 源默认不换,选 y 才换(需 sudo,先备份原源文件)。
  • 选 1 或 2 → 从清华下载安装 conda,并自动配置 .condarc 与 pip 清华源。
  • 选 3(默认) → 完全不动 conda / pip 源。
  • 非交互终端(管道或无人值守)下会自动使用默认选项:apt=不换源、conda=不装。

可选的配置变量(不改变上面的交互选择)

# 指定 oh-my-zsh 固定版本 tag(保证可复现)
OH_MY_ZSH_TAG=2024.07.22 bash bootstrap.sh

# 指定不同 gitlink 用户
GITLINK_USER=yourname bash bootstrap.sh

# 自定义 conda 安装路径(默认 ~/miniconda3 或 ~/anaconda3)
MINICONDA_PREFIX=$HOME/miniconda3 ANACONDA_PREFIX=$HOME/anaconda3 bash bootstrap.sh

# 指定 Anaconda 版本(默认自动解析清华 archive 最新版,解析失败回退 2026.07-1)
ANACONDA_VERSION=2026.07-1 bash bootstrap.sh

脚本做了什么

  1. apt:按需切换清华源(需 sudo,自动备份原源),并安装基础工具 zsh git tmux curl wget vim openssh-server
  2. 从 gitlink 克隆 ohmyzsh 到 ~/.oh-my-zsh,写入个人 ~/.zshrc
  3. 从 gitlink 克隆 oh-my-tmux 配置到 ~/.tmux,复制 .tmux.conf 并写入 ~/.tmux.conf.local
  4. conda:交互选择 Miniconda / Anaconda / 不装(默认)
  5. pip:装了 conda 才配置 conda 与 pip 清华源(.condarc)
  6. 设置 zsh 为默认 shell

脚本幂等:已安装 / 已配置的内容会自动跳过,可重复运行。

安装后验证

zsh --version     # zsh 已安装
exec zsh          # 切换后应出现自定义提示符(绿色/红色 ➜)
tmux              # 进入 tmux,状态栏样式生效
ssh localhost     # openssh-server 正常(可选)
conda --version   # 装了 conda 时(重新登录后自动激活)
pip config list   # 装了 conda 时,应显示 index-url 为清华源

兼容性说明

  • 支持 Ubuntu 20.04 ~ 26.04(及衍生版)。Debian 请自行调整 apt 源部分。
  • 架构自动判断:amd64/i386 用 ubuntu 源,arm64/armhf/riscv64 等用 ubuntu-ports 源。
  • conda 安装包架构:x86_64 / aarch64 / ppc64le / s390x(官方支持范围;armhf/riscv64 等无官方安装包,会提示跳过)。
  • apt 换源同时兼容旧版 legacy sources.list(20.04 / 22.04)与新版 deb822 ubuntu.sources(24.04+),按系统实际文件自动选择。
  • 换 apt 源会先备份原文件(.bak.<时间戳>),可随时回滚。
  • 建议给 oh-my-zsh 锁定一个 tag(OH_MY_ZSH_TAG),避免上游迭代导致配置 API 漂移。

版权与许可

本项目 ubuntu-env-setup 采用 MIT 许可(见 LICENSE)。

本仓库引用 / fork 的第三方内容,版权归原作者所有,仅作镜像与配置复用:

内容 上游 许可
oh-my-zsh 配置框架 ohmyzsh/ohmyzsh MIT
tmux 配置框架 gpakosz/.tmux MIT / WTFPL

fork 的镜像仓库(ohmyzsh、oh-my-tmux)中保留了上游的 LICENSE 文件,请勿删除。README 中已声明上游来源,符合宽松开源协议的要求。

关于

Ubuntu 开发环境一键搭建脚本。在新装的 Ubuntu 机器上,通过 gitlink(中科院 CCF 开源平台)快速拉取并配置 zsh + oh-my-zsh + tmux,并按需交互式切换 apt / conda / pip 到清华(TUNA)镜像源。

43.0 KB
邀请码
    Gitlink(确实开源)
  • 加入我们
  • 官网邮箱:gitlink@ccf.org.cn
  • QQ群
  • QQ群
  • 公众号
  • 公众号

版权所有:中国计算机学会技术支持:开源发展技术委员会
京ICP备13000930号-9 京公网安备 11010802047560号