# WSL 安装、状态查看、开机自启与保活命令教程

本文把几篇教程整理成一份偏命令速查的版本，适合 Windows 10/11 安装 WSL、查看运行状态、验证环境，以及配置登录后自动拉起 WSL。

示例发行版统一写成 `Ubuntu`。如果你的发行版叫 `Ubuntu-22.04`、`Ubuntu-24.04` 或 `Debian`，把命令里的 `Ubuntu` 替换成自己的名称即可。

## 1. 安装 WSL

先用管理员身份打开 PowerShell。

![管理员 PowerShell 示例](images/01-admin-powershell.jpg)

### 一条命令安装默认 Ubuntu

```powershell
wsl --install
```

安装完成后按提示重启电脑。重启后第一次打开 Ubuntu，会要求创建 Linux 用户名和密码。

### 查看可安装的 Linux 发行版

```powershell
wsl --list --online
```

也可以写成：

```powershell
wsl -l -o
```

### 安装指定发行版

```powershell
wsl --install -d Ubuntu
```

示例：

```powershell
wsl --install -d Ubuntu-24.04
wsl --install -d Debian
```

### 手动启用 WSL 组件

如果 `wsl --install` 报错，可先手动启用 Windows 功能，再重启：

```powershell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
```

重启后设置默认使用 WSL 2：

```powershell
wsl --set-default-version 2
```

更新 WSL：

```powershell
wsl --update
```

## 2. 启动和进入 WSL

进入默认发行版：

```powershell
wsl
```

进入指定发行版：

```powershell
wsl -d Ubuntu
```

以 root 用户进入：

```powershell
wsl -d Ubuntu -u root
```

设置默认发行版：

```powershell
wsl --set-default Ubuntu
```

把某个发行版切换到 WSL 2：

```powershell
wsl --set-version Ubuntu 2
```

## 3. 查看状态命令

查看已安装发行版、运行状态和 WSL 版本：

```powershell
wsl -l -v
```

![wsl -l -v 状态示例](images/02-wsl-list-status.jpg)

查看当前 WSL 基本状态：

```powershell
wsl --status
```

查看 WSL 客户端版本：

```powershell
wsl --version
```

查看正在运行的发行版：

```powershell
wsl --list --running
```

关闭所有 WSL 发行版：

```powershell
wsl --shutdown
```

只关闭某个发行版：

```powershell
wsl --terminate Ubuntu
```

## 4. 安装后验证命令

进入 WSL 后执行：

```bash
cat /etc/os-release
uname -a
whoami
pwd
```

验证 apt 可用：

```bash
sudo apt update
```

验证网络：

```bash
curl -I https://www.microsoft.com
```

验证能访问 Windows 磁盘：

```bash
ls /mnt/c
```

从 WSL 打开当前目录的 Windows 文件资源管理器：

```bash
explorer.exe .
```

## 5. 常用维护命令

更新 WSL：

```powershell
wsl --update
```

更新 Ubuntu 软件包：

```bash
sudo apt update
sudo apt upgrade -y
```

导出备份：

```powershell
wsl --export Ubuntu D:\backup\ubuntu.tar
```

从备份导入：

```powershell
wsl --import Ubuntu D:\WSL\Ubuntu D:\backup\ubuntu.tar --version 2
```

注销并删除某个发行版。执行前务必确认已备份：

```powershell
wsl --unregister Ubuntu
```

## 6. 开机自启方案一：启动文件夹 + VBS

这个方案简单，适合只想在登录 Windows 后自动启动 WSL 的情况。

按 `Win + R`，输入：

```text
shell:startup
```

![打开 Windows 启动文件夹](images/03-shell-startup.png)

在打开的启动文件夹里新建文件：

```text
start-wsl.vbs
```

写入下面内容：

```vbscript
Set shell = CreateObject("WScript.Shell")
shell.Run "wsl.exe -d Ubuntu -e sh -lc ""nohup sleep infinity >/tmp/wsl-keepalive.log 2>&1 &""", 0, False
```

![启动文件夹中的 VBS 示例](images/04-vbs-startup.png)

说明：

- `0` 表示隐藏窗口。
- `False` 表示脚本不等待 WSL 命令结束。
- `sleep infinity` 是一个轻量保活进程，让 WSL 不会刚启动就退出。
- 如果发行版不是 `Ubuntu`，替换 `-d Ubuntu`。

验证：

```powershell
wsl -l -v
```

如果看到 `Ubuntu` 的 `STATE` 是 `Running`，说明自启生效。

## 7. 开机自启方案二：任务计划 + WSL 保活

这个方案比启动文件夹更可控，适合需要长期运行 Docker、SSH、数据库、frp、脚本服务等场景。

在 PowerShell 中执行：

```powershell
$Action = New-ScheduledTaskAction -Execute "wsl.exe" -Argument "-d Ubuntu -e sh -lc ""nohup sleep infinity >/tmp/wsl-keepalive.log 2>&1 &"""
$Trigger = New-ScheduledTaskTrigger -AtLogOn
Register-ScheduledTask -TaskName "WSL Ubuntu Keepalive" -Action $Action -Trigger $Trigger -Description "Start Ubuntu WSL on user logon" -Force
```

立即测试任务：

```powershell
Start-ScheduledTask -TaskName "WSL Ubuntu Keepalive"
wsl -l -v
```

删除任务：

```powershell
Unregister-ScheduledTask -TaskName "WSL Ubuntu Keepalive" -Confirm:$false
```

如果你想让它开机但不登录也运行，需要在“任务计划程序”图形界面里把触发器改成“启动时”，并配置用户凭据。普通个人电脑一般用“登录时”就够了。

## 8. systemd 服务方式保活

如果你的 WSL 版本支持 systemd，推荐先启用 systemd，再把需要长期运行的进程做成服务。

检查 WSL 版本：

```powershell
wsl --version
```

进入 WSL，编辑 `/etc/wsl.conf`：

```bash
sudo nano /etc/wsl.conf
```

写入：

```ini
[boot]
systemd=true
```

回到 PowerShell 重启 WSL：

```powershell
wsl --shutdown
wsl -d Ubuntu
```

验证 systemd：

```bash
systemctl is-system-running
systemctl list-unit-files --type=service
```

创建一个 keepalive 服务：

```bash
sudo tee /etc/systemd/system/wsl-keepalive.service >/dev/null <<'EOF'
[Unit]
Description=Keep WSL instance alive

[Service]
Type=simple
ExecStart=/usr/bin/tail -f /dev/null
Restart=always

[Install]
WantedBy=multi-user.target
EOF
```

启用并启动：

```bash
sudo systemctl daemon-reload
sudo systemctl enable --now wsl-keepalive.service
```

查看服务状态：

```bash
systemctl status wsl-keepalive.service --no-pager
```

停止并禁用：

```bash
sudo systemctl disable --now wsl-keepalive.service
```

注意：systemd 服务只能在 WSL 发行版已经启动后生效。要让 Windows 登录后自动拉起 WSL，仍然需要配合“启动文件夹 VBS”或“任务计划”。

## 9. 更适合真实服务的写法

如果你要保活的不是 WSL 本身，而是某个具体服务，建议不要只依赖 `sleep infinity`，而是把真实服务写成 systemd 服务。

例如启动 SSH：

```bash
sudo apt install -y openssh-server
sudo systemctl enable --now ssh
systemctl status ssh --no-pager
```

例如启动 Docker。前提是你已安装 Docker Engine 或 Docker Desktop WSL 集成：

```bash
sudo systemctl enable --now docker
systemctl status docker --no-pager
```

这样更容易查看日志、重启服务和排错：

```bash
journalctl -u ssh -n 100 --no-pager
sudo systemctl restart ssh
```

## 10. 排错速查

`wsl --install` 报虚拟化相关错误：

```powershell
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --update
```

然后检查 BIOS/UEFI 是否启用了虚拟化。

配置 `/etc/wsl.conf` 后没生效：

```powershell
wsl --shutdown
```

等待几秒后重新进入 WSL。Microsoft 文档提到，WSL 配置变更需要等发行版完全停止后再重新启动才会应用。

DNS 或网络异常时可先重启 WSL：

```powershell
wsl --shutdown
wsl
```

确认发行版名：

```powershell
wsl -l -v
```

确认 WSL 内部保活进程：

```bash
ps -ef | grep -E "sleep infinity|tail -f /dev/null" | grep -v grep
```

## 参考来源

- 腾讯云开发者社区：[Windows 11 上轻松安装 WSL，实现秒开 Linux 开发环境！](https://cloud.tencent.com/developer/article/2539992)
- CSDN：[Windows 开机自启动 WSL](https://blog.csdn.net/weixin_43228381/article/details/138874028)
- 百度 Comate：[保活相关教程](https://comate.baidu.com/zh/page/5rlb9qzh4yj)
- Microsoft Learn：[WSL 基本命令](https://learn.microsoft.com/zh-cn/windows/wsl/basic-commands)
- Microsoft Learn：[WSL 中的高级设置配置](https://learn.microsoft.com/zh-cn/windows/wsl/wsl-config)
- Microsoft Learn：[使用 systemd 通过 WSL 管理 Linux 服务](https://learn.microsoft.com/zh-cn/windows/wsl/systemd)


WSL安装_状态查看_开机自启保活命令教程

# OpenWrt FRPC 快速命令版

```sh
# 查看系统架构
uname -m
opkg print-architecture
cat /proc/cpuinfo
```

```text
mips_*      -> linux_mips
mipsel_*    -> linux_mipsle
arm_*       -> linux_arm
aarch64_*   -> linux_arm64
x86_64      -> linux_amd64
```

```sh
# 示例：下载 mipsle 版本
cd /root
mkdir -p frpc && cd frpc
wget https://github.com/fatedier/frp/releases/download/v0.68.1/frp_0.68.1_linux_mipsle.tar.gz
tar -zxvf frp_0.68.1_linux_mipsle.tar.gz
cd frp_0.68.1_linux_mipsle
chmod +x frpc
./frpc -v
```

```sh
# 放到固定目录
mkdir -p /etc/frp
cp /root/frpc/frp_0.68.1_linux_mipsle/frpc /usr/bin/frpc
chmod +x /usr/bin/frpc
cp /root/frpc/frpc.toml /etc/frp/frpc.toml
```

```sh
# 手动测试
/usr/bin/frpc -c /etc/frp/frpc.toml
```

```sh
# 创建开机启动和保活脚本
cat >/etc/init.d/frpc <<'EOF'
#!/bin/sh /etc/rc.common

USE_PROCD=1
START=99
STOP=10

PROG=/usr/bin/frpc
CONFIG=/etc/frp/frpc.toml

start_service() {
    [ -x "$PROG" ] || return 1
    [ -f "$CONFIG" ] || return 1

    procd_open_instance
    procd_set_param command "$PROG" -c "$CONFIG"
    procd_set_param respawn 5 10 0
    procd_set_param stdout 1
    procd_set_param stderr 1
    procd_close_instance
}
EOF
chmod +x /etc/init.d/frpc
```

```sh
# 开机自启 + 立即启动
/etc/init.d/frpc enable
/etc/init.d/frpc start
```

```sh
# 常用管理命令
/etc/init.d/frpc restart
/etc/init.d/frpc stop
/etc/init.d/frpc status
ps | grep frpc
logread -e frpc
```

```sh
# 重启后验证
reboot
ps | grep frpc
logread -e frpc
```

```sh
# 如果使用 ini 配置，把下面路径替换掉
/etc/frp/frpc.toml
/etc/frp/frpc.ini
```


OpenWrt_FRPC_快速命令版

# 老版本 NAS 安装 docker-compose/docker compose 命令

## 背景

在一些老版本的 NAS 系统中，Docker 可能已经安装，但 `docker-compose` 命令不可用或版本过旧。此时可以手动下载并安装 `docker-compose` 二进制文件。

一键命令版本：

docker compose命令版本：

`sh -c 'PLUGIN_DIR="/usr/local/lib/docker/cli-plugins"; mkdir -p "$PLUGIN_DIR" 2>/dev/null || PLUGIN_DIR="/usr/lib/docker/cli-plugins"; [ -d "$PLUGIN_DIR" ] || mkdir -p "$PLUGIN_DIR"; curl -L "https://gh-proxy.org/https://github.com/docker/compose/releases/latest/download/docker-compose-linux-aarch64" -o "$PLUGIN_DIR/docker-compose" && chmod +x "$PLUGIN_DIR/docker-compose" && docker compose version'`










## 安装步骤

### 1. 下载 docker-compose 二进制文件

使用 `curl` 从 GitHub 下载 `docker-compose` 1.29.2 版本（通过 gh-proxy 加速）：

```bash
sudo curl -L "https://gh-proxy.org/https://github.com/docker/compose/releases/download/1.29.2/docker-compose-Linux-x86_64" -o /usr/local/bin/docker-compose
```

### 2. 添加执行权限

下载完成后，为 `docker-compose` 文件添加可执行权限：

```bash
sudo chmod +x /usr/local/bin/docker-compose
```

### 3. 验证安装

检查 `docker-compose` 是否安装成功：

```bash
docker-compose --version
```

如果输出类似以下内容，说明安装成功：

```
docker-compose version 1.29.2, build 5becea4c
```

## 注意事项

- **架构兼容性**：上述命令适用于 `x86_64` 架构。如果你的 NAS 是 ARM 架构（如某些群晖型号），需要下载对应的 ARM 版本：
  ```bash
  sudo curl -L "https://gh-proxy.org/https://github.com/docker/compose/releases/download/1.29.2/docker-compose-Linux-armv7" -o /usr/local/bin/docker-compose
  ```

- **版本选择**：1.29.2 是较为稳定的版本，兼容性好。如果需要更新版本，可以访问 [Docker Compose Releases](https://github.com/docker/compose/releases) 查看最新版本号并替换 URL 中的版本号。

- **权限问题**：如果执行时提示权限不足，确保使用 `sudo` 或以 root 用户身份运行命令。

- **路径问题**：`/usr/local/bin` 通常在系统 `PATH` 中，如果不在，可以手动添加或将文件放到 `/usr/bin` 目录。

## 卸载

如果需要卸载，直接删除二进制文件即可：

```bash
sudo rm /usr/local/bin/docker-compose
```

## 参考

- [Docker Compose 官方文档](https://docs.docker.com/compose/)
- [Docker Compose GitHub Releases](https://github.com/docker/compose/releases)


安装docker-compose工具-针对老nas

主流工具是 ufw（默认简易防火墙）和 iptables（底层防火墙工具）

### 基于ufw

查看已启用的防火墙规则

sudo ufw status

查看编号规则（方便删除指定规则）

sudo ufw status numbered



### 基于 iptables

查看 filter 表规则（默认表，处理转发、入站出站）

sudo iptables -L

合并添加两个端口（一行完成，效率更高）

sudo iptables -A INPUT -p tcp -m multiport --dports 15566,13000 -j ACCEPT


### 基于 nftables（新一代防火墙，逐步替代 iptables）
sudo nft list ruleset

仅开放「TCP 协议」端口（最常用，服务默认多为 TCP）

方式1：合并开放两个TCP端口（推荐，一行完成）
sudo ufw allow 15566/tcp,13000/tcp

方式2：分开开放两个TCP端口（逻辑更清晰，新手友好）
sudo ufw allow 15566/tcp
sudo ufw allow 13000/tcp







防火墙相关命令

---
title: TeslaMate 数据备份及恢复
category: Docker备份教学
updatedAt: 2026-05-03T09:20:00+08:00
createdAt: 2025-12-28T12:41:52.743Z
---

![TeslaMate 数据备份及恢复](https://file0.52tesla.com/xtbf/f63ba567c18e4508bdd3c4f496d74f95/636bc20f?x-oss-process=image%2F%2Fquality%2CQ_30%2Fformat%2Cwebp%2Fresize%2Cw_1280%2Climit_0)

# TeslaMate 数据备份及恢复

官方文档： [Backup and Restore | TeslaMate](https://docs.teslamate.org/docs/maintenance/backup_restore)

这篇文章把我之前博客里的基础备份恢复方法，以及最近实际在用的 `bump` 备份方案整合到一起。  
如果你只是想快速上手，建议优先看前面的 `bump` 方案；如果你只是单机手动维护，也可以看后面的基础命令版。

## 一句话结论

- 目前更推荐使用 PostgreSQL 的 `custom format dump`，也就是 `pg_dump -Fc`
- 恢复时更推荐使用 `pg_restore`
- 最稳妥的做法，是备份前先停止 `teslamate` 应用容器，数据库容器保持运行
- 恢复前要清理 `public` 和 `private` 两个 schema，避免新版本迁移时出现 `private.tokens` 冲突
- 如果你更看重不停机，也可以直接在线备份，通常也能正常使用
- 除了数据库文件，最好把镜像版本、`docker-compose.yml`、`.env` 一起保存

# 一、推荐方案：使用 bump 脚本自动备份

这是我现在更推荐的方案，适合长期运行、批量管理、远程自动备份。

## 1. bump 方案在做什么

`bump` 目录里的脚本，本质上做的是下面这些事情：

1. 找到 TeslaMate 的 PostgreSQL 容器
2. 使用 `pg_dump -Fc` 生成完整数据库备份
3. 把备份文件复制到宿主机
4. 上传到 WebDAV 等远程位置
5. 多台机器时，可由总控脚本统一分发执行

相比早期直接导出 `.bck` 文本 SQL，这种方式有几个优点：

- 同时包含数据库结构和数据
- 更适合跨机器迁移
- 更适合完整恢复
- 恢复时更不容易遗漏对象
- 更适合长期自动化备份

## 2. 备份前要不要停止 TeslaMate

建议做法：停止 `teslamate` 应用容器，再执行备份。

原因：

- TeslaMate 运行时会持续写入 PostgreSQL
- 停止应用后，备份结果更稳定
- 可以减少备份过程中数据变化带来的不一致风险

推荐状态：

- `teslamate` 容器：停止
- `postgres` 容器：保持运行
- `grafana`、`mosquitto`、`wemate`：可停可不停

不过如果你不能接受短暂停机，也可以在线备份。`pg_dump` 本身支持一致性快照导出，所以不停机备份通常也是可用的，只是从运维稳妥性上略弱一些。

我现在的脚本已经支持这两种模式：

- `STOP_TESLAMATE_BEFORE_BACKUP=1`：先停应用再备份
- `STOP_TESLAMATE_BEFORE_BACKUP=0`：不停机直接在线备份

如果你只是给自己使用，并且更在意不中断服务，可以直接在线备份。  
如果你准备给别人做迁移、恢复，或者希望尽量降低恢复翻车概率，还是建议先停应用再备份。

## 3. 标准备份流程

下面示例假设：

- PostgreSQL 容器名：`teslamate-database-1`
- TeslaMate 容器名：`teslamate-teslamate-1`
- 数据库名：`teslamate`
- 数据库用户：`teslamate`
- 备份文件名：`./teslamate.dump`

### 方案 A：更稳妥，先停应用再备份

```bash
docker stop teslamate-teslamate-1
docker exec teslamate-database-1 pg_dump -U teslamate -d teslamate -Fc -f /teslamate.dump
docker cp teslamate-database-1:/teslamate.dump ./teslamate.dump
docker exec teslamate-database-1 rm -f /teslamate.dump
docker start teslamate-teslamate-1
```

### 方案 B：不停机在线备份

```bash
docker exec teslamate-database-1 pg_dump -U teslamate -d teslamate -Fc -f /teslamate.dump
docker cp teslamate-database-1:/teslamate.dump ./teslamate.dump
docker exec teslamate-database-1 rm -f /teslamate.dump
```

参数说明：

- `-U teslamate`：数据库用户
- `-d teslamate`：数据库名
- `-Fc`：使用 PostgreSQL 自定义格式导出
- `-f /teslamate.dump`：在数据库容器中生成临时备份文件

## 4. 如何确认备份成功

备份完成后，先看文件是否存在、大小是否正常：

```bash
ls -lh ./teslamate.dump
```

如果还想进一步验证备份结构，可以查看归档内容：

```bash
pg_restore -l ./teslamate.dump
```

如果输出里能看到表、schema、索引等对象，通常说明这个备份文件结构上是有效的。

## 5. 备份时建议顺手保存的内容

除了数据库备份文件，建议再额外保存：

- TeslaMate 镜像版本
- PostgreSQL 镜像版本
- `docker-compose.yml`
- `.env` 或相关环境变量文件

原因很简单：很多恢复失败，不是备份文件坏了，而是恢复时直接用了不合适的新版本。

查看镜像版本可以用：

```bash
docker ps --format 'table {{.Names}}\t{{.Image}}'
docker inspect teslamate-teslamate-1 --format '{{.Config.Image}}'
docker inspect teslamate-database-1 --format '{{.Config.Image}}'
```

推荐把这些信息和 `teslamate.dump` 放在同一个备份目录里。

# 二、推荐恢复方案：使用 custom dump 恢复

恢复时的核心原则：

- 尽量恢复到一个全新的 PostgreSQL 数据卷中
- 恢复时先不要让 TeslaMate 应用运行
- 尽量先用和备份来源相同或接近的 TeslaMate 版本启动
- 先确认旧数据恢复成功，再考虑升级到新版本

很多人恢复失败，根本原因不是“不会导入”，而是把下面三种状态混在了一起：

- 旧备份数据
- 新版本迁移结果
- 半初始化状态的数据库结构

所以更稳妥的思路是：先恢复干净数据库，再启动 TeslaMate。

特别注意：新版 TeslaMate 会使用 `private` schema 存放部分敏感表。如果目标数据库之前已经被新版本启动过，或者迁移失败过，里面可能已经有 `private.tokens`。这时再恢复旧备份，TeslaMate 启动迁移时会尝试把 `public.tokens` 移到 `private.tokens`，然后报错：

```text
ERROR 42P07 (duplicate_table) relation "tokens" already exists in schema "private"
```

解决方法不是改 compose，而是在恢复前明确清空 `public` 和 `private` 两个 schema。

## 1. 标准恢复流程

假设：

- PostgreSQL 容器已经创建并运行
- TeslaMate 应用容器先保持停止
- 你要恢复的文件是 `./teslamate.dump`

### 第一步：停止 TeslaMate

```bash
docker stop teslamate-teslamate-1
```

如果你使用的是 `docker compose`，也可以这样停：

```bash
docker compose stop teslamate grafana
docker compose up -d database
```

### 第二步：确认 dump 格式

`pg_dump -Fc` 生成的 custom dump 文件开头通常是 `PGDMP`：

```bash
head -c 5 ./teslamate.dump
echo
```

如果输出是 `PGDMP`，就用 `pg_restore`。如果输出是 `--` 或者能看到 SQL 文本，那是普通 SQL dump，参考后面的“基础命令版恢复”。

### 第三步：清理目标库的 public 和 private schema

```bash
docker exec -i teslamate-database-1 psql -U teslamate -d teslamate <<'SQL'
DROP SCHEMA IF EXISTS public CASCADE;
DROP SCHEMA IF EXISTS private CASCADE;
CREATE SCHEMA public;
CREATE EXTENSION IF NOT EXISTS cube WITH SCHEMA public;
CREATE EXTENSION IF NOT EXISTS earthdistance WITH SCHEMA public;
SQL
```

如果你使用的是 `docker compose` 服务名：

```bash
docker compose exec -T database psql -U teslamate -d teslamate <<'SQL'
DROP SCHEMA IF EXISTS public CASCADE;
DROP SCHEMA IF EXISTS private CASCADE;
CREATE SCHEMA public;
CREATE EXTENSION IF NOT EXISTS cube WITH SCHEMA public;
CREATE EXTENSION IF NOT EXISTS earthdistance WITH SCHEMA public;
SQL
```

这一步是为了避免目标库残留新版本创建的 `private.tokens`，导致恢复后 TeslaMate 迁移失败。

### 第四步：执行 custom dump 恢复

方式 A：先复制到数据库容器内再恢复：

```bash
docker cp ./teslamate.dump teslamate-database-1:/teslamate.dump
docker exec teslamate-database-1 pg_restore -U teslamate -d teslamate --clean --if-exists --no-owner --role=teslamate /teslamate.dump
docker exec teslamate-database-1 rm -f /teslamate.dump
```

方式 B：直接从当前目录管道恢复，适合 `docker compose`：

```bash
cat ./teslamate.dump | docker compose exec -T database pg_restore -U teslamate -d teslamate --clean --if-exists --no-owner --role=teslamate
```

- `pg_restore`：恢复 `pg_dump -Fc` 生成的备份
- `--clean`：恢复前按备份归档里的对象清理旧对象
- `--if-exists`：对象不存在时忽略删除报错
- `--no-owner`：不强制恢复原数据库对象 owner，跨机器迁移更稳
- `--role=teslamate`：用当前环境里的 `teslamate` 角色创建对象
- 前一步手动清理 `private`，是为了处理旧 dump 里没有 `private` schema、但目标库已经残留 `private.tokens` 的情况

### 第五步：启动 TeslaMate

```bash
docker start teslamate-teslamate-1
```

如果使用 `docker compose`：

```bash
docker compose up -d
```

### 第六步：查看日志确认启动状态

```bash
docker logs -f teslamate-teslamate-1
```

如果使用 `docker compose`：

```bash
docker compose logs -f teslamate
```

## 2. 恢复完成后的检查方法

先检查容器是否正常运行：

```bash
docker ps
```

查看 TeslaMate 最近日志：

```bash
docker logs --tail 100 teslamate-teslamate-1
```

如果要进一步检查 PostgreSQL 里的表和迁移记录：

```bash
docker exec -it teslamate-database-1 psql -U teslamate -d teslamate
```

检查表：

```sql
SELECT schemaname, tablename
FROM pg_tables
WHERE schemaname IN ('public', 'private')
ORDER BY schemaname, tablename;
```

检查迁移记录：

```sql
SELECT version FROM schema_migrations ORDER BY version;
```

## 3. 哪些情况下不建议直接恢复到现有库

以下情况，不建议直接往当前数据库硬导入：

- 当前数据库已经被新版本 TeslaMate 初始化过
- 当前数据库已经处于迁移失败状态
- 你不确定目标库是不是空库
- 目标环境已经出现 schema 和 migration 不一致的问题

更稳妥的做法是：

- 删除旧 PostgreSQL 数据卷后重新创建
- 或者新建一个全新的 PostgreSQL 容器或数据卷
- 在 TeslaMate 启动前先完成恢复

# 三、兼容旧教程：基础命令版备份与恢复

如果你只是单机手动操作，也可以继续使用以前这种基础命令方式。  
不过要注意，这种 `.bck` 方式本质是 SQL 文本导出，适合简单场景，不如 `pg_dump -Fc` 稳妥。

## 1. 备份

假设你的目录是：

```bash
cd /home/pi/teslamate
```

执行备份：

```bash
docker compose exec -T database pg_dump -U teslamate teslamate > ./teslamate.bck
```

如果当前目录生成了 `teslamate.bck`，说明备份已完成。

## 2. 恢复

先停止 TeslaMate：

```bash
docker compose stop teslamate
docker compose up -d database
```

重建 schema 和扩展。这里必须同时清理 `public` 和 `private`，否则新版本 TeslaMate 可能会因为 `private.tokens` 已存在而迁移失败：

```bash
docker compose exec -T database psql -U teslamate -d teslamate <<'SQL'
DROP SCHEMA IF EXISTS public CASCADE;
DROP SCHEMA IF EXISTS private CASCADE;
CREATE SCHEMA public;
CREATE EXTENSION IF NOT EXISTS cube WITH SCHEMA public;
CREATE EXTENSION IF NOT EXISTS earthdistance WITH SCHEMA public;
SQL
```

进入备份目录：

```bash
cd /home/pi/teslamate
```

导入备份文件：

```bash
docker compose exec -T database psql -U teslamate -d teslamate < teslamate.bck
```

如果你的文件开头是 `PGDMP`，说明它不是文本 SQL，而是 `pg_dump -Fc` 生成的 custom dump。不要用上面的 `psql < teslamate.bck`，改用：

```bash
cat teslamate.bck | docker compose exec -T database pg_restore -U teslamate -d teslamate --clean --if-exists --no-owner --role=teslamate
```

最后启动 TeslaMate：

```bash
docker compose start teslamate
```

# 四、最佳实践建议

- 每次升级 TeslaMate 或 PostgreSQL 前先做一次完整备份
- 优先使用 `pg_dump -Fc` 和 `pg_restore`
- 尽量不要长期使用 `latest` 标签
- 保留多个历史备份，不要总覆盖一个文件
- 定期做一次恢复演练，不要只备份不验证
- 如果备份比较旧，恢复后优先先用源版本启动，再考虑升级

# 五、一句话原则

使用 `pg_dump -Fc` 备份完整 PostgreSQL 数据库，恢复到干净的数据库环境中，并优先使用与备份来源一致或接近的 TeslaMate 版本启动，整体成功率会高很多。
