Tmux 入门教程：让 SSH 断线和多任务终端不再中断

背景

当你在服务器上部署项目、查看日志、运行 Docker 服务或使用 Claude Code / Codex 时，常会遇到几个问题：

• SSH 网络短暂断开后，正在运行的命令也跟着中断；
• 一个终端窗口只能做一件事，查看日志、编辑配置、执行命令需要频繁切换；
• 重新登录服务器后，找不到刚才的工作现场。

tmux 是一个终端复用工具。它可以在一台服务器上创建多个可持续运行的终端会话，并把一个终端划分为多个窗口和面板。

最实用的能力是：SSH 断开不等于任务停止。只要 tmux 会话仍在运行，重新连接服务器后就可以继续回到原来的工作环境。

本文以 Debian / Ubuntu 服务器为例，讲清楚 tmux 的安装、基础操作、远程使用方式和常见问题。

步骤

1. 安装 tmux

Debian / Ubuntu 可以直接使用 apt 安装：

1
sudo apt update
2
sudo apt install -y tmux

确认是否安装成功：

1
tmux -V

如果终端输出类似下面的版本号，说明安装完成：

1
tmux 3.x

其他常见系统的安装命令如下：

1
# Fedora / Rocky Linux / AlmaLinux
2
sudo dnf install -y tmux
3

4
# CentOS 7
5
sudo yum install -y tmux
6

7
# macOS（已安装 Homebrew）
8
brew install tmux

Windows 用户建议先安装并使用 WSL，再在 WSL 的 Linux 环境中安装 tmux。

2. 先理解 tmux 的三个核心概念

tmux 的操作对象可以理解为三层：

1. Session（会话）：一个独立的工作空间，例如一个项目或一台服务器的运维环境；
2. Window（窗口）：会话中的标签页；
3. Pane（面板）：一个窗口内部切分出的多个终端区域。

下面是一个常见结构：

1
tmux server
2
└── Session: project-api
3
    ├── Window 1: editor
4
    │   ├── Pane 1: 编辑代码
5
    │   └── Pane 2: 运行后端服务
6
    └── Window 2: logs
7
        └── Pane 1: 查看 Docker / Nginx 日志

日常使用时，可以把一个项目对应一个 Session，把不同任务拆到不同 Window，再用 Pane 同时查看多个命令输出。

3. 创建第一个 tmux 会话

创建一个名为 dev 的会话：

1
tmux new -s dev

进入 tmux 后，终端底部通常会出现状态栏，显示当前会话名、窗口编号和时间。

tmux 默认使用：

1
Ctrl-b

作为前缀键。后续大部分快捷键都需要先按一次 Ctrl-b，松开后再按功能键。

例如，分离会话的快捷键是：

1
Ctrl-b，然后按 d

也可以写成：

1
Ctrl-b d

按下后会回到普通 Shell，但 tmux 中正在运行的任务不会停止。

4. 查看、进入和关闭会话

查看当前机器上的 tmux 会话：

1
tmux ls

也可以使用：

1
tmux list-sessions

重新进入名为 dev 的会话：

1
tmux attach -t dev

简写：

1
tmux a -t dev

当机器上只有一个会话时，可以直接执行：

1
tmux a

关闭指定会话：

1
tmux kill-session -t dev

关闭所有 tmux 会话和 tmux 服务：

1
tmux kill-server

tmux kill-server 会终止所有 tmux 内运行的任务，生产服务器上不要随意执行。

5. 使用窗口：把不同任务分开

在 tmux 内创建新窗口：

1
Ctrl-b c

在窗口之间切换：

1
Ctrl-b n    # 下一个窗口
2
Ctrl-b p    # 上一个窗口
3
Ctrl-b 0    # 切换到编号为 0 的窗口
4
Ctrl-b 1    # 切换到编号为 1 的窗口

重命名当前窗口：

1
Ctrl-b ,

例如，你可以把窗口命名为：

1
api
2
logs
3
database
4
deploy

也可以在命令行中直接创建带名称的窗口：

1
tmux new-window -t dev -n logs

适合把项目开发、服务日志、数据库连接和部署命令分到不同窗口中管理。

6. 使用分屏：一个窗口同时看多个终端

在当前窗口中上下分屏：

1
Ctrl-b "

在当前窗口中左右分屏：

1
Ctrl-b %

切换到相邻面板：

1
Ctrl-b 方向键

例如：

1
Ctrl-b ←
2
Ctrl-b →
3
Ctrl-b ↑
4
Ctrl-b ↓

关闭当前面板：

1
exit

或者：

1
Ctrl-b x

调整面板大小：

1
Ctrl-b Ctrl-方向键

例如按住 Ctrl-b 后连续按 Ctrl-Left，可以缩小或扩大相邻面板。

一个很实用的布局是：

1
┌───────────────────────┬───────────────────────┐
2
│ 编辑代码 / Claude Code │ 后端服务日志          │
3
├───────────────────────┼───────────────────────┤
4
│ Docker 状态 / 数据库   │ 临时执行命令          │
5
└───────────────────────┴───────────────────────┘

7. 在 SSH 服务器上正确使用 tmux

远程服务器是 tmux 最常见的使用场景。

先连接服务器：

1
ssh user@your-server-ip

进入服务器后创建会话：

1
tmux new -s server-work

然后在 tmux 内运行任务，例如：

1
docker compose logs -f

1
python main.py

1
npm run dev

即使本地网络断开、关闭 SSH 客户端，tmux 会话通常仍会在服务器上继续运行。

下次重新连接服务器后，恢复现场：

1
ssh user@your-server-ip
2
tmux attach -t server-work

推荐按项目或用途命名会话：

1
tmux new -s monitoring
2
tmux new -s blog
3
tmux new -s ai-terminal
4
tmux new -s homelab

这样即使服务器上有多个项目，也能快速定位工作环境。

8. 快速进入或创建会话

每次都执行“先判断会话是否存在，再创建或进入”比较麻烦。可以使用下面这条命令：

1
tmux new-session -A -s dev

参数含义：

1
-A：会话已存在时直接进入，不存在时才创建
2
-s：指定会话名称

因此，日常进入项目环境只需要：

1
tmux new-session -A -s project-name

例如：

1
tmux new-session -A -s api-service

这也是最推荐记住的一条 tmux 命令。

9. 复制、滚动和查看历史输出

tmux 默认可以保留一定数量的终端历史输出。

进入复制模式：

1
Ctrl-b [

进入后可以使用方向键、PageUp、PageDown 浏览历史内容。

退出复制模式：

1
q

搜索内容：

1
Ctrl-b [
2
/
3
输入关键字后按 Enter

为了保留更多日志历史，可以在 ~/.tmux.conf 中增加：

1
set -g history-limit 50000

修改配置后，在 tmux 内执行：

1
Ctrl-b :
2
source-file ~/.tmux.conf

或者直接在 Shell 中执行：

1
tmux source-file ~/.tmux.conf

10. 编写一个适合开发与运维的基础配置

创建或编辑 tmux 配置文件：

1
nano ~/.tmux.conf

写入以下配置：

1
# 开启鼠标支持：可点击窗口、选择面板、拖动调整分屏大小
2
set -g mouse on
3

4
# 增加终端历史输出行数，便于回看日志
5
set -g history-limit 50000
6

7
# 窗口和面板从 1 开始编号，更符合日常使用习惯
8
set -g base-index 1
9
setw -g pane-base-index 1
10

11
# 新窗口自动沿用当前路径
12
bind c new-window -c "#{pane_current_path}"
13

14
# 新面板自动沿用当前路径
15
bind '"' split-window -v -c "#{pane_current_path}"
16
bind % split-window -h -c "#{pane_current_path}"
17

18
# 使用 | 和 - 作为更直观的分屏快捷键
19
bind | split-window -h -c "#{pane_current_path}"
20
bind - split-window -v -c "#{pane_current_path}"
21

22
# 使用 r 重新加载 tmux 配置
23
bind r source-file ~/.tmux.conf \; display-message "tmux config reloaded"
24

25
# 状态栏刷新间隔
26
set -g status-interval 5

保存后重新加载：

1
tmux source-file ~/.tmux.conf

之后可直接使用：

1
Ctrl-b |

进行左右分屏，使用：

1
Ctrl-b -

进行上下分屏。

注意：配置中的 bind '"' 和 bind % 保留了 tmux 默认分屏方式，因此旧习惯不会失效。

11. 一个完整的开发工作流示例

假设你正在开发一个 FastAPI 项目，可以按下面的方式组织 tmux：

1
tmux new-session -A -s api-project

进入后创建四个面板：

1
┌────────────────────┬────────────────────┐
2
│ uv run main.py     │ git status         │
3
├────────────────────┼────────────────────┤
4
│ docker compose logs│ Claude Code / shell│
5
└────────────────────┴────────────────────┘

每个面板分别运行：

1
# 面板 1：启动后端
2
uv run main.py

1
# 面板 2：查看 Git 状态
2
watch -n 3 git status --short

1
# 面板 3：查看容器日志
2
docker compose logs -f

1
# 面板 4：执行临时命令、运行 AI 编程工具或处理部署任务

需要离开时：

1
Ctrl-b d

第二天继续开发时：

1
tmux new-session -A -s api-project

项目环境就会恢复到之前的会话中。

常见问题

1. SSH 断开后，为什么 tmux 里的任务还在运行？

tmux 运行在服务器本机，而不是运行在你的 SSH 客户端中。

SSH 只是连接到服务器并显示 tmux 的画面。网络断开时，tmux 会话依然由服务器进程维持，所以重新连接后可以继续进入原来的 Session。

但需要注意：服务器重启、tmux 服务被杀掉，或会话中的程序本身异常退出时，任务仍然会停止。

2. 执行 tmux a 报错或无法进入正确会话怎么办？

先查看全部会话：

1
tmux ls

然后指定会话名进入：

1
tmux attach -t session-name

例如：

1
tmux attach -t monitoring

如果显示没有任何 session，说明当前没有正在运行的 tmux 会话，需要重新创建：

1
tmux new -s monitoring

3. 为什么分离后重新连接显示 “sessions should be nested with care”？

这通常表示：你已经在一个 tmux 会话里，又尝试进入另一个 tmux 会话。

例如，本地终端已经运行 tmux，然后 SSH 到远程服务器后又执行 tmux attach。

这并不一定是错误，但快捷键会有冲突。需要把前缀键传递给内部 tmux 时，可以按两次前缀键：

1
Ctrl-b Ctrl-b

第一组会被外层 tmux 识别，第二组会发送给内层 tmux。

更简单的做法是：本地和远程都使用 tmux 时，尽量明确知道自己当前处于哪一层，并避免频繁嵌套。

4. 鼠标滚轮不能滚动历史日志怎么办？

先确认配置中已经开启鼠标：

1
set -g mouse on

然后重新加载配置：

1
tmux source-file ~/.tmux.conf

如果仍然无法滚动，可以进入复制模式后查看：

1
Ctrl-b [

不同终端模拟器、SSH 客户端和 Windows 终端对鼠标滚轮的处理可能略有差异，但复制模式是通用方案。

5. tmux 会话会自动退出怎么办？

当 Session 中最后一个窗口和最后一个 Shell 都退出时，tmux 会话会结束。

最常见的原因是误执行：

1
exit

或者关闭了唯一的窗口。

正常离开 tmux 应该使用：

1
Ctrl-b d

这是“分离会话”，不会终止其中运行的任务。

6. tmux 能替代 systemd、Docker 或 Supervisor 吗？

不能完全替代。

tmux 适合人工交互式任务，例如开发、排查故障、临时运行服务、查看日志和保持 SSH 工作现场。

长期运行的生产服务仍然应该使用更合适的进程管理方式：

1
Web 服务：systemd / Docker Compose / Kubernetes
2
后台任务：systemd / Supervisor / Celery
3
日志收集：Loki / ELK / OpenSearch 等

tmux 更像是运维和开发人员的“持久化终端工作台”。

总结

tmux 的核心价值不是复杂的快捷键，而是把终端从“一次性的 SSH 窗口”变成“可恢复的工作环境”。

日常只需要先掌握这几项：

1
tmux new -s name          创建会话
2
tmux new-session -A -s name  进入或创建会话
3
tmux ls                   查看会话
4
tmux a -t name            恢复会话
5
Ctrl-b d                  分离会话
6
Ctrl-b c                  创建窗口
7
Ctrl-b " / Ctrl-b %       上下 / 左右分屏
8
Ctrl-b 方向键             切换面板

对于需要长期 SSH 管理服务器、开发多个项目、运行日志监控或使用 AI 编程工具的场景，tmux 是非常值得尽早养成习惯的基础工具。

如果你在服务器上部署服务，可以继续看 Docker 安装与使用教程：从零部署第一个容器服务；排查项目目录时，Tree 命令教程：快速查看和导出目录结构 也很常用。快捷键和配置细节建议参考 tmux 官方 Wiki。