203 lines
4.8 KiB
Markdown
203 lines
4.8 KiB
Markdown
# ZSH 配置同步方案
|
|
|
|
这个目录包含了完整的 oh-my-zsh 配置，可以在多个 VPS 之间同步使用。
|
|
|
|
## 文件结构
|
|
|
|
```
|
|
configuration/zsh/
|
|
├── README.md # 本文件
|
|
├── install-zsh-config.sh # 完整安装脚本
|
|
├── quick-install.sh # 快速安装脚本
|
|
├── zshrc.template # ZSH 配置文件模板
|
|
└── oh-my-zsh-custom/ # 自定义 oh-my-zsh 配置
|
|
├── aliases.zsh # 自定义别名
|
|
└── plugins/ # 自定义插件
|
|
```
|
|
|
|
## 使用方法
|
|
|
|
### 方法一：智能安装（推荐）
|
|
|
|
询问用户是否使用代理，安装完成后可选择是否保持：
|
|
|
|
```bash
|
|
# 智能安装（询问代理使用，安装后可选择是否保持）
|
|
curl -fsSL https://ben:8d7d70f324796be650b79415303c31f567bf459b@gitea.tailnet-68f9.ts.net/ben/mgmt/raw/branch/main/configuration/zsh/smart-install.sh | bash
|
|
```
|
|
|
|
**特点：**
|
|
- 安装前询问是否使用代理
|
|
- 测试代理连接确保可用
|
|
- 安装完成后询问是否保持代理
|
|
- 用户完全控制代理使用
|
|
|
|
### 方法二：快速安装
|
|
|
|
在新 VPS 上运行：
|
|
|
|
```bash
|
|
# 一键安装
|
|
curl -fsSL https://ben:8d7d70f324796be650b79415303c31f567bf459b@gitea.tailnet-68f9.ts.net/ben/mgmt/raw/branch/main/configuration/zsh/quick-install.sh | bash
|
|
```
|
|
|
|
### 方法三：手动安装
|
|
|
|
1. 克隆仓库：
|
|
```bash
|
|
git clone https://ben:8d7d70f324796be650b79415303c31f567bf459b@gitea.tailnet-68f9.ts.net/ben/mgmt.git /root/mgmt
|
|
```
|
|
|
|
2. 运行安装脚本：
|
|
```bash
|
|
cd /root/mgmt
|
|
chmod +x configuration/zsh/install-zsh-config.sh
|
|
./configuration/zsh/install-zsh-config.sh
|
|
```
|
|
|
|
## 配置同步
|
|
|
|
安装完成后，可以使用以下命令同步最新配置：
|
|
|
|
```bash
|
|
# 同步配置
|
|
sync-zsh-config
|
|
```
|
|
|
|
这个命令会：
|
|
1. 从 Gitea 拉取最新配置
|
|
2. 备份当前配置
|
|
3. 部署新配置
|
|
|
|
## 代理管理
|
|
|
|
如果网络环境需要代理，可以使用以下命令管理代理：
|
|
|
|
```bash
|
|
# 代理管理命令
|
|
proxy-on # 临时开启代理
|
|
proxy-off # 临时关闭代理
|
|
proxy-toggle # 切换代理状态
|
|
proxy-enable # 永久开启代理
|
|
proxy-disable # 永久关闭代理
|
|
proxy-status # 查看代理状态
|
|
proxy-test # 测试代理连接
|
|
```
|
|
|
|
### 代理使用场景
|
|
|
|
- **临时使用**: `proxy-on` → 使用代理 → `proxy-off`
|
|
- **永久开启**: `proxy-enable` → 重启后仍然有效
|
|
- **快速切换**: `proxy-toggle` → 一键切换状态
|
|
- **状态检查**: `proxy-status` → 查看当前状态和IP
|
|
|
|
## 包含的功能
|
|
|
|
### 插件
|
|
- **git** - Git 集成
|
|
- **docker** - Docker 支持
|
|
- **ansible** - Ansible 支持
|
|
- **terraform** - OpenTofu/Terraform 支持
|
|
- **kubectl** - Kubernetes 支持
|
|
- **zsh-autosuggestions** - 命令自动建议
|
|
- **zsh-syntax-highlighting** - 语法高亮
|
|
- **zsh-completions** - 增强补全
|
|
|
|
### 别名
|
|
- **项目管理**: `mgmt-status`, `mgmt-deploy`, `mgmt-cleanup`
|
|
- **Ansible**: `ansible-check`, `ansible-deploy`, `ansible-ping`
|
|
- **OpenTofu**: `tofu-init`, `tofu-plan`, `tofu-apply`
|
|
- **Docker**: `dps`, `dex`, `dlog`, `dclean`
|
|
- **Kubernetes**: `k`, `kgp`, `kgs`, `kaf`
|
|
- **Git**: `gs`, `ga`, `gc`, `gp`, `gl`
|
|
- **系统**: `ll`, `la`, `ports`, `myip`
|
|
|
|
### 主题
|
|
- **agnoster** - 功能丰富的主题，显示 Git 状态
|
|
|
|
## 更新配置
|
|
|
|
当您在主 VPS 上更新配置后：
|
|
|
|
1. 提交更改：
|
|
```bash
|
|
cd /root/mgmt
|
|
git add configuration/zsh/
|
|
git commit -m "Update zsh configuration"
|
|
git push origin main
|
|
```
|
|
|
|
2. 在其他 VPS 上同步：
|
|
```bash
|
|
sync-zsh-config
|
|
```
|
|
|
|
## 自定义配置
|
|
|
|
如果您需要在特定 VPS 上添加自定义配置：
|
|
|
|
1. 编辑 `~/.zshrc` 文件
|
|
2. 在文件末尾添加您的自定义配置
|
|
3. 这些配置不会被同步脚本覆盖
|
|
|
|
## 故障排除
|
|
|
|
### 如果自动建议插件不工作
|
|
```bash
|
|
# 运行测试脚本检查插件状态
|
|
chmod +x /root/mgmt/configuration/zsh/test-plugins.sh
|
|
/root/mgmt/configuration/zsh/test-plugins.sh
|
|
|
|
# 手动安装缺失的插件
|
|
cd ~/.oh-my-zsh/custom/plugins
|
|
git clone https://github.com/zsh-users/zsh-autosuggestions
|
|
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git
|
|
git clone https://github.com/zsh-users/zsh-completions
|
|
|
|
# 重新加载配置
|
|
source ~/.zshrc
|
|
```
|
|
|
|
### 如果同步失败
|
|
```bash
|
|
# 检查网络连接
|
|
ping gitea.tailnet-68f9.ts.net
|
|
|
|
# 手动拉取
|
|
cd /root/mgmt
|
|
git pull origin main
|
|
```
|
|
|
|
### 如果别名不工作
|
|
```bash
|
|
# 重新加载配置
|
|
source ~/.zshrc
|
|
|
|
# 检查别名
|
|
alias | grep <alias-name>
|
|
```
|
|
|
|
### 如果插件不工作
|
|
```bash
|
|
# 检查插件目录
|
|
ls ~/.oh-my-zsh/plugins/
|
|
ls ~/.oh-my-zsh/custom/plugins/
|
|
|
|
# 运行测试脚本
|
|
/root/mgmt/configuration/zsh/test-plugins.sh
|
|
```
|
|
|
|
## 安全说明
|
|
|
|
- 此配置包含访问 Gitea 的凭据
|
|
- 请确保只在可信的 VPS 上使用
|
|
- 建议定期更新访问令牌
|
|
|
|
## 支持
|
|
|
|
如有问题，请检查：
|
|
1. 网络连接是否正常
|
|
2. Git 凭据是否正确
|
|
3. 依赖包是否已安装
|
|
4. 权限是否正确
|