# 部署带HTTPS的生产环境VanBlog指南

## 准备工作

1. **确保已安装Docker和Docker Compose**
   - 参考前置知识中的安装步骤

2. **准备域名**
   - 拥有一个有效域名（如example.com）
   - 将域名A记录解析到你的服务器IP

3. **开放服务器端口**
   - 确保服务器防火墙开放80和443端口
   - `sudo ufw allow 80,443/tcp` (Ubuntu)



## 详细部署步骤

### 1. 创建项目目录结构

```bash
mkdir -p ~/vanblog-production/{caddy-proxy,data}
cd ~/vanblog-production
```

### 2. 创建Caddy配置文件

创建 `caddy-proxy/Caddyfile` 文件：

```caddyfile
# 全局配置
{
    email your-email@example.com  # 替换为你的邮箱
    acme_ca https://acme-v02.api.letsencrypt.org/directory
}

# 主域名配置
your-domain.com {
    # 反向代理到VanBlog容器
    reverse_proxy vanblog:80
    
    # 安全增强配置
    header {
        Strict-Transport-Security "max-age=31536000;"
        X-Content-Type-Options nosniff
        X-Frame-Options DENY
        Referrer-Policy strict-origin-when-cross-origin
    }
    
    # 性能优化
    encode zstd gzip
}

# www域名重定向
www.your-domain.com {
    redir https://your-domain.com{uri} permanent
}

# HTTP重定向到HTTPS
http:// {
    redir https://{host}{uri} permanent
}
```

### 3. 创建Docker Compose文件

创建 `docker-compose.yml` 文件：

```yaml
version: '3.8'

networks:
  vanblog-network:
    driver: bridge

services:
  vanblog:
    image: kevinchina/deeplearning:vanblog-latest
    restart: unless-stopped
    environment:
      TZ: Asia/Shanghai
      EMAIL: your-email@example.com  # 替换为你的邮箱
      NODE_ENV: production
      VAN_BLOG_VERSION: latest
    volumes:
      - ./data/static:/app/static
      - ./log:/var/log
      - ./caddy/config:/root/.config/caddy
      - ./caddy/data:/root/.local/share/caddy
      - ./aliyunpan/config:/root/.config/aliyunpan
    networks:
      - vanblog-network
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:80"]
      interval: 30s
      timeout: 10s
      retries: 3

  caddy:
    image: caddy:latest
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./caddy-proxy/Caddyfile:/etc/caddy/Caddyfile
      - ./caddy/data:/data
      - ./caddy/config:/config
    networks:
      - vanblog-network
    depends_on:
      vanblog:
        condition: service_healthy

  mongo:
    image: mongo:5.0
    restart: unless-stopped
    environment:
      TZ: Asia/Shanghai
    volumes:
      - ./data/mongo:/data/db
    networks:
      - vanblog-network
    healthcheck:
      test: echo 'db.runCommand("ping").ok' | mongosh localhost:27017/test --quiet
      interval: 30s
      timeout: 10s
      retries: 3
```

### 4. 替换配置项

在启动前，请确保替换以下内容：
- 将 `your-domain.com` 替换为你的实际域名
- 将 `your-email@example.com` 替换为你的实际邮箱

### 5. 启动服务

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

### 6. 验证部署

1. **检查服务状态**
   ```bash
   docker compose ps
   ```

2. **查看日志**
   ```bash
   docker compose logs -f caddy  # 查看证书申请情况
   docker compose logs -f vanblog  # 查看应用日志
   ```

3. **访问测试**
   - 访问 `http://your-domain.com` 应自动跳转到HTTPS
   - 检查浏览器地址栏的锁图标，确认证书有效

## 高级配置选项

### 1. 自定义MongoDB认证（推荐）

修改 `docker-compose.yml` 中mongo服务部分：

```yaml
mongo:
  image: mongo:5.0
  environment:
    MONGO_INITDB_ROOT_USERNAME: admin
    MONGO_INITDB_ROOT_PASSWORD: your-strong-password
  # 其他配置保持不变...
```

然后在vanblog服务中添加环境变量：
```yaml
vanblog:
  environment:
    # 原有环境变量...
    MONGO_USERNAME: admin
    MONGO_PASSWORD: your-strong-password
```

### 2. 使用Cloudflare代理

修改 `Caddyfile`：

```caddyfile
your-domain.com {
    reverse_proxy vanblog:80
    
    # Cloudflare专用配置
    tls {
        dns cloudflare {env.CF_API_TOKEN}
    }
    
    # 其他配置保持不变...
}
```

在docker-compose.yml中caddy服务添加环境变量：
```yaml
caddy:
  environment:
    CF_API_TOKEN: "your-cloudflare-api-token"
```

### 3. 定期备份配置

创建备份脚本 `backup.sh`：

```bash
#!/bin/bash
BACKUP_DIR="/path/to/backups"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")

# 备份MongoDB
docker compose exec mongo mongodump --archive --gzip > $BACKUP_DIR/vanblog-mongo-$TIMESTAMP.gz

# 备份静态文件
tar czvf $BACKUP_DIR/vanblog-static-$TIMESTAMP.tar.gz ./data/static

# 备份Caddy配置
tar czvf $BACKUP_DIR/vanblog-caddy-$TIMESTAMP.tar.gz ./caddy-proxy ./caddy
```

## 维护命令

1. **更新VanBlog**
   ```bash
   docker compose pull vanblog
   docker compose up -d
   ```

2. **重启服务**
   ```bash
   docker compose restart
   ```

3. **查看资源使用**
   ```bash
   docker stats
   ```

4. **清理无用资源**
   ```bash
   docker system prune
   ```

## 故障排除

1. **证书申请失败**
   - 检查域名解析是否正确
   - 确保80端口可被外部访问
   - 查看Caddy日志：`docker compose logs caddy`

2. **MongoDB连接问题**
   - 检查MongoDB容器是否正常运行
   - 查看日志：`docker compose logs mongo`

3. **VanBlog无法访问**
   - 检查服务状态：`docker compose ps`
   - 查看应用日志：`docker compose logs vanblog`

通过以上步骤，你已经成功部署了一个带HTTPS的生产级VanBlog环境，具有自动证书续期、安全增强和性能优化等特性。

二开vanblog

以下是一个修改后的Nginx配置，用于将 `teek.ysundy.com` 反向代理到主机的8085端口：



```nginx
server {
    listen 80;
    listen [::]:80;
    server_name teek.ysundy.com;
    
    access_log  /home/wwwlogs/teek.ysundy.com.log;
    
    location / {
        proxy_pass http://127.0.0.1:8085;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # 如果需要处理WebSocket连接，添加以下行
        # proxy_http_version 1.1;
        # proxy_set_header Upgrade $http_upgrade;
        # proxy_set_header Connection "upgrade";
    }
    
    # 静态文件缓存设置（可选）
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        proxy_pass http://127.0.0.1:8085;
        proxy_cache_valid 200 302 12h;
        proxy_cache_valid 404 1m;
        expires 12h;
    }
    
    # 保留原有的well-known目录访问权限（用于SSL证书验证等）
    location ~ /.well-known {
        allow all;
    }
}
```

这个配置做了以下修改：
1. 移除了原有的root目录和PHP相关配置
2. 添加了反向代理配置，将所有请求转发到8085端口
3. 保留了基本的日志记录和静态文件缓存设置
4. 保留了SSL证书验证所需的.well-known目录访问权限

如果你的静态网站不需要PHP支持，这个配置应该可以正常工作。如果需要PHP支持，你可能需要在8085端口的服务中处理，或者根据需要调整配置。

注意：配置修改后需要重新加载Nginx配置：
```bash
sudo nginx -t  # 测试配置是否正确
sudo systemctl reload nginx  # 重新加载配置
```

你可以在同一个 `server` 块中添加 301 跳转强制 HTTPS，但最佳实践是使用 **两个单独的 `server` 块**，一个专门处理 HTTP 到 HTTPS 的重定向，另一个处理 HTTPS 的反向代理。  

### **优化后的配置（HTTP 跳转 HTTPS + 反向代理到 8085）**
#### **1. HTTP 强制跳转 HTTPS（301 永久重定向）**
```nginx
server {
    listen 80;
    listen [::]:80;
    server_name teek.ysundy.com;
    
    # 301 永久重定向到 HTTPS
    return 301 https://$host$request_uri;
    
    access_log /home/wwwlogs/teek.ysundy.com_http.log;
}
```

#### **2. HTTPS 反向代理到 8085**
```nginx
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name teek.ysundy.com;
    
    # SSL 证书配置（必须）
    ssl_certificate /path/to/your/fullchain.pem;    # 替换为你的证书路径
    ssl_certificate_key /path/to/your/privkey.pem;  # 替换为你的私钥路径
    
    # SSL 优化配置（可选但推荐）
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    
    access_log /home/wwwlogs/teek.ysundy.com_https.log;
    
    # 反向代理配置
    location / {
        proxy_pass http://127.0.0.1:8085;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # 如果需要 WebSocket 支持
        # proxy_http_version 1.1;
        # proxy_set_header Upgrade $http_upgrade;
        # proxy_set_header Connection "upgrade";
    }
    
    # 静态文件缓存（可选）
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        proxy_pass http://127.0.0.1:8085;
        proxy_cache_valid 200 302 12h;
        proxy_cache_valid 404 1m;
        expires 12h;
    }
    
    # 保留 ACME（Let's Encrypt 证书验证）
    location ~ /.well-known {
        allow all;
    }
}
```

### **关键点说明**
1. **HTTP → HTTPS 301 跳转**  
   - 第一个 `server` 块监听 `80` 端口，直接返回 `301` 永久重定向到 HTTPS。
   - 这样用户访问 `http://teek.ysundy.com` 会自动跳转到 `https://teek.ysundy.com`。

2. **HTTPS 反向代理**  
   - 第二个 `server` 块监听 `443` 端口，配置 SSL 证书，并代理到 `8085` 端口。
   - 必须配置 `ssl_certificate` 和 `ssl_certificate_key`，否则 HTTPS 无法工作。

3. **SSL 优化（可选但推荐）**  
   - 使用 `TLSv1.2` 和 `TLSv1.3`，禁用不安全的旧版本（如 TLSv1.0、TLSv1.1）。
   - 优化加密套件，提高安全性。

4. **WebSocket 支持（可选）**  
   - 如果你的 8085 端口服务使用 WebSocket（如 Node.js、WebRTC），取消注释相关配置。

### **如何获取 SSL 证书？**
如果你还没有 SSL 证书，可以使用 **Let's Encrypt** 免费申请：
```bash
sudo apt install certbot python3-certbot-nginx  # Debian/Ubuntu
sudo certbot --nginx -d teek.ysundy.com        # 自动申请并配置
```
Certbot 会自动修改 Nginx 配置，并设置自动续签。

### **测试并重载 Nginx**
```bash
sudo nginx -t         # 检查配置是否正确
sudo systemctl reload nginx  # 重新加载配置
```
现在访问 `http://teek.ysundy.com` 会自动跳转到 `https://teek.ysundy.com`，并通过反向代理访问 `8085` 端口的服务。





----
从你提供的 `diff` 输出来看，系统检测到 `/etc/init.d/nginx` 文件存在冲突，可能是因为你之前安装了 **LNMP 2.0**，而现在系统（或某个更新）尝试安装一个新的版本。  

### **如何处理？**
你有几个选项：
1. **`Y` 或 `I`** → 安装软件包维护者的版本（可能会覆盖 LNMP 的配置）  
2. **`N` 或 `O`** → 保留 LNMP 2.0 的版本（推荐，因为 LNMP 可能有特殊优化）  
3. **`D`** → 查看具体差异（你已经看到）  
4. **`Z`** → 暂停当前操作，进入 shell 检查  

### **推荐做法**
由于你使用的是 **LNMP 2.0**，它可能对 Nginx 进行了定制化修改（比如 PHP-FPM 集成、特殊优化等），所以建议：
- **选择 `N`（保留当前版本）**，避免 LNMP 的功能被覆盖。  

### **如果已经误覆盖了怎么办？**
如果已经不小心选择了 `Y`（覆盖），可以尝试：
1. **从 LNMP 2.0 重新安装 Nginx**：
   ```bash
   cd /root/lnmp2.0  # 进入 LNMP 目录
   ./install.sh nginx
   ```
2. **手动恢复 `/etc/init.d/nginx`**（如果有备份）：
   ```bash
   cp /etc/init.d/nginx /etc/init.d/nginx.bak  # 先备份当前版本
   wget -O /etc/init.d/nginx "https://raw.githubusercontent.com/your-lnmp-repo/lnmp2.0/master/init.d/nginx"  # 从 LNMP 官方恢复
   chmod +x /etc/init.d/nginx
   ```

### **后续建议**
- **LNMP 2.0 的管理命令**（推荐使用 LNMP 自带的控制脚本）：
  ```bash
  lnmp nginx {start|stop|reload|restart|status}
  ```
  而不是直接使用：
  ```bash
  service nginx restart   # 或 systemctl restart nginx
  ```
- **如果未来需要升级 Nginx**，建议通过 LNMP 2.0 的升级脚本，而不是 `apt`/`yum`，避免兼容性问题。

### **结论**
**选择 `N`（保留当前 LNMP 2.0 的版本）**，确保 LNMP 的管理功能不受影响。
-----


根据你的错误信息，Nginx 启动失败的主要原因是 **端口冲突**（80 和 443 端口已被占用），同时还存在 **重复的 server_name 配置**。以下是完整的解决方案：

---

## **1. 检查并杀死占用 80/443 端口的进程**
### **(1) 查看占用端口的进程**
```bash
sudo netstat -tulnp | grep -E ':80|:443'
```
或
```bash
sudo lsof -i :80
sudo lsof -i :443
```
### **(2) 强制终止占用进程**
```bash
sudo pkill -9 nginx    # 杀死所有 Nginx 进程
sudo fuser -k 80/tcp   # 强制释放 80 端口
sudo fuser -k 443/tcp  # 强制释放 443 端口
```

---

## **2. 解决 `conflicting server name` 警告**
错误信息：
```
nginx: [warn] conflicting server name "teek.ysundy.com" on 0.0.0.0:80, ignored
```
说明 **Nginx 配置中存在重复的 `server_name`**，可能因为：
- Certbot 修改了 `/etc/nginx/sites-enabled/default`，但 LNMP 有自己的配置文件（如 `/usr/local/nginx/conf/vhost/teek.ysundy.com.conf`）。
- 同一域名在多个配置文件中被定义。

### **解决方法**
#### **(1) 检查所有 Nginx 配置文件**
```bash
grep -r "teek.ysundy.com" /etc/nginx/ /usr/local/nginx/conf/
```
#### **(2) 保留一个配置，删除或注释其他重复配置**
- 如果是 LNMP，保留 `/usr/local/nginx/conf/vhost/teek.ysundy.com.conf`，删除或注释其他文件中的配置。
- 如果是 Certbot 自动生成的配置，可以合并到 LNMP 的配置中。

---

## **3. 修正 Nginx 配置**
### **(1) 确保证书路径正确**
编辑 LNMP 的虚拟主机配置（通常位于 `/usr/local/nginx/conf/vhost/teek.ysundy.com.conf`）：
```nginx
server {
    listen 80;
    server_name teek.ysundy.com;
    return 301 https://$host$request_uri;  # HTTP 跳转 HTTPS
}

server {
    listen 443 ssl http2;
    server_name teek.ysundy.com;

    # Certbot 提供的证书路径
    ssl_certificate /etc/letsencrypt/live/teek.ysundy.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/teek.ysundy.com/privkey.pem;

    # 其他配置（如反向代理到 8085 端口）
    location / {
        proxy_pass http://127.0.0.1:8085;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
```
### **(2) 测试配置并重启**
```bash
sudo nginx -t           # 测试配置
lnmp nginx restart      # LNMP 专用重启命令
```

---

## **4. 如果问题仍然存在**
### **(1) 检查 Nginx 是否以其他方式运行**
```bash
ps aux | grep nginx
```
如果发现多个 Nginx 进程，可能是系统服务和 LNMP 冲突：
```bash
sudo systemctl stop nginx   # 停止系统 Nginx 服务
sudo systemctl disable nginx  # 禁用系统 Nginx 服务
lnmp nginx restart          # 使用 LNMP 管理
```

### **(2) 彻底清理 Nginx 进程**
```bash
sudo pkill -9 nginx
sudo rm -f /usr/local/nginx/logs/nginx.pid  # 删除 PID 文件
lnmp nginx start
```

---

## **5. 验证 HTTPS 访问**
```bash
curl -I https://teek.ysundy.com
```
应返回 `200 OK`。

---

## **总结**
1. **杀死占用 80/443 端口的进程**：`sudo pkill -9 nginx` + `sudo fuser -k 80/tcp`。  
2. **解决 `conflicting server name`**：删除重复配置，保留 LNMP 的虚拟主机文件。  
3. **修正证书路径**：确保指向 `/etc/letsencrypt/live/teek.ysundy.com/`。  
4. **优先使用 `lnmp nginx restart`**，避免与系统 Nginx 服务冲突。  

如果仍有问题，请提供：
- `grep -r "teek.ysundy.com" /etc/nginx/ /usr/local/nginx/conf/` 的输出  
- `ps aux | grep nginx` 的结果。

---

网站nginx配置备忘

# 一个biome配置模板

下面是一个biome配置模板，主要适配了 ts格式的规则






```json
{
  // ==================================================================
  // 基础配置
  // ==================================================================
  "$schema": "https://biomejs.dev/schemas/2.0.6/schema.json",
  // "extends": null, // 可继承其他配置（如："biome:recommended"）

  // ==================================================================
  // 文件系统配置
  // ==================================================================
  "files": {
    // 文件大小限制（字节）
    "maxSize": 1048576, // 默认 1MB

    // 包含/排除规则（示例）：
    // "include": ["src/**/*.{js,ts}"],  // 明确包含的文件模式
    // "ignore": ["temp/**"],           // 要忽略的文件模式

    "ignoreUnknown": false // 是否忽略未知文件类型（默认false）
  },

  // ==================================================================
  // 版本控制(VCS)配置
  // ==================================================================
  "vcs": {
    "enabled": false, // 是否启用VCS集成（默认false）
    "clientKind": "git", // 版本控制系统类型（git/svn等，默认git）
    "useIgnoreFile": false, // 是否使用.gitignore等文件（默认false）
    "root": ".", // VCS根目录（默认当前目录）
    "defaultBranch": "main" // 默认分支名称（默认main）
  },

  // ==================================================================
  // 代码检查器(Linter)配置
  // ==================================================================
  "linter": {
    "enabled": true, // 是否启用代码检查（默认true）

    // 文件包含/排除规则
    "includes": [
      "**", // 默认检查所有文件
      "!**/__fixtures__", // 排除测试夹具目录
      "!**/__mocks__", // 排除模拟目录
      "!**/dist", // 排除构建输出目录
      "!**/node_modules", // 排除依赖目录
      "!**/.yarn", //排除 Yarn 缓存目录
      "!**/.history", // 排除历史记录文件
      "!**/build", // 排除构建目录
      "!**/coverage", // 排除测试覆盖率报告目录
      "!**/jest.config.js", // 排除 Jest 配置文件
      "!**/jest.transform.js", // 排除 Jest 转换文件
      "!**/docusaurus.config.ts", // 排除 Docusaurus 配置文件
      "!**/sidebars.js", // 排除侧边栏配置文件
      "!**/*.md", // 排除 Markdown 文件
      "!**/lib" // 排除 lib 目录
    ],

    // ======================
    // 规则集配置
    // ======================
    "rules": {
      "recommended": false, // 是否启用全部推荐规则（默认true）

      // 代码复杂度规则
      "complexity": {
        "noBannedTypes": "error", // 禁止使用特定类型（如any）
        "noUselessTypeConstraint": "error", // 禁止无用的类型约束
        "noForEach": "off" // 是否禁用forEach（默认off）
      },

      // 代码正确性规则
      "correctness": {
        "noPrecisionLoss": "error", // 禁止数字精度丢失
        "noUnusedVariables": "off" // 未使用变量检查（默认off）
      },

      // 实验性规则（可能变更）
      "nursery": {
        "useSortedClasses": "error" // 强制类成员排序
      },

      // 性能相关规则
      "performance": {
        "recommended": true // 启用全部推荐性能规则（默认true）
      },

      // 安全相关规则
      "security": {
        "recommended": true // 启用全部推荐安全规则（默认true）
      },

      // 代码风格规则
      "style": {
        "noNamespace": "error", // 禁止namespace语法
        "useAsConstAssertion": "error", // 强制as const断言
        "noUselessElse": "error" // 禁止无用else语句
      },

      // 可疑代码模式检测
      "suspicious": {
        "noExtraNonNullAssertion": "error", // 禁止多余的非空断言
        "noMisleadingInstantiator": "error", // 检测误导性的实例化
        "noUnsafeDeclarationMerging": "error", // 不安全的声明合并
        "noExplicitAny": "off", // 禁止使用any类型（默认off，从one-biome补充）
        "noArrayIndexKey": "off" // 禁止数组索引作为key（默认off，从one-biome补充）
      }
    }
  },

  // ==================================================================
  // 代码格式化(Formatter)配置
  // ==================================================================
  "formatter": {
    "enabled": true, // 是否启用格式化（默认true）

    // 格式化范围控制
    "includes": ["**", "!**/lib"], // 包含/排除文件
    // "ignore": ["**/node_modules/**", "**/dist/**"], // 默认 []

    // 核心格式化选项
    "formatWithErrors": false, // 是否在格式化时显示错误（默认false）
    "indentStyle": "space", // 缩进风格（space/tab，默认tab）
    "indentWidth": 2, // 缩进空格数（默认2）
    "lineWidth": 120, // 行宽限制（默认80）
    "lineEnding": "lf", // 行尾符（lf/crlf，默认lf）
    "attributePosition": "auto" // HTML属性位置（auto/multiline等，默认auto）
  },

  // ==================================================================
  // 辅助功能配置
  // ==================================================================
  "assist": {
    "actions": {
      "source": {
        "organizeImports": "on" // 自动整理import语句（默认on）
      }
    }
  },

  // ==================================================================
  // JavaScript 特定配置
  // ==================================================================
  "javascript": {
    // 解析器选项
    "parser": {
      "unsafeParameterDecoratorsEnabled": false // 禁用不安全的装饰器语法（默认false）
    },

    // JS格式化风格
    "formatter": {
      "quoteStyle": "single", // 字符串引号风格（默认double）
      "jsxQuoteStyle": "double", // JSX引号风格（默认double）
      "quoteProperties": "asNeeded", // 对象属性引号规则（asNeeded/preserve，默认asNeeded）
      "trailingCommas": "all", // 尾随逗号规则（all/es5/none，默认all）
      "semicolons": "asNeeded", // 分号使用规则（always/asNeeded，默认always）
      "arrowParentheses": "asNeeded", // 箭头函数括号规则（always/asNeeded，默认always）
      "enabled": true, // 是否启用JS格式化（默认true）
      "indentStyle": "space", // 缩进风格（space/tab，默认tab）
      "indentWidth": 2, // 缩进空格数（默认2）
      "lineEnding": "lf", // 行尾符（lf/crlf，默认lf）
      "lineWidth": 120, // 行宽限制（默认80）
      "bracketSameLine": false, // 括号是否同行（默认false）
      "bracketSpacing": true, // 括号空格（默认true）
      "attributePosition": "auto" // 属性位置（默认auto）
    },

    // 全局变量白名单
    "globals": ["$", "_", "externalVariable"], // 默认[]

    // JSX运行时配置
    "jsxRuntime": "reactClassic", // JSX转换方式（transparent/reactClassic，默认transparent）

    "linter": {
      "enabled": true // 是否启用JS检查（默认true）
    }
  },

  // ==================================================================
  // JSON 文件配置
  // ==================================================================
  "json": {
    "parser": {
      "allowComments": true // 允许JSON中的注释（默认false）
    },
    "formatter": {
      "enabled": true, // 是否启用JSON格式化（默认true）
      "indentStyle": "space", // 缩进风格（space/tab，默认tab）
      "indentWidth": 2, // 缩进空格数（默认2）
      "lineEnding": "lf", // 行尾符（lf/crlf，默认lf）
      "lineWidth": 120, // 行宽限制（默认80）
      "trailingCommas": "none" // 尾随逗号规则（none/all，默认none）
    },
    "linter": {
      "enabled": true // 是否启用JSON检查（默认true）
    }
  },

  // ==================================================================
  // CSS 文件配置
  // ==================================================================
  "css": {
    "parser": {
      "cssModules": true // 启用CSS Modules语法（默认false）
    },
    "formatter": {
      "enabled": false, // 是否启用CSS格式化（默认false）
      "indentStyle": "space", // 缩进风格（space/tab，默认tab）
      "indentWidth": 2, // 缩进空格数（默认2）
      "lineEnding": "lf", // 行尾符（lf/crlf，默认lf）
      "lineWidth": 80, // 行宽限制（默认80）
      "quoteStyle": "double" // CSS引号风格（double/single，默认double）
    },
    "linter": {
      "enabled": false // 是否启用CSS检查（默认false）
    }
  },

  // ==================================================================
  // 文件类型覆盖规则
  // ==================================================================
  "overrides": [
    {
      // TypeScript文件特殊规则
      "includes": ["**/*.ts", "**/*.tsx", "**/*.mts", "**/*.cts"],
      "linter": {
        "rules": {
          "correctness": {
            "noConstAssign": "off", // 允许常量重新赋值
            "noGlobalObjectCalls": "off",
            "noInvalidConstructorSuper": "off",
            "noSetterReturn": "off",
            "noUndeclaredVariables": "off",
            "noUnreachable": "off",
            "noUnreachableSuper": "off",
            "noInvalidBuiltinInstantiation": "off"
          },

          // TypeScript风格规则
          "style": {
            "useConst": "error" // 强制使用const
          },

          // TypeScript特定规则
          "suspicious": {
            "noDuplicateClassMembers": "off",
            "noDuplicateObjectKeys": "off",
            "noDuplicateParameters": "off",
            "noFunctionAssign": "off",
            "noImportAssign": "off",
            "noRedeclare": "off",
            "noUnsafeNegation": "off",
            "useGetterReturn": "off",
            "noVar": "error" // 禁止使用var
          },
          "complexity": {
            "noArguments": "error"
          }
        }
      }
    }
  ]
}
```

一个biome配置模板

# 解决 TortoiseGit 安全目录问题的自动化脚本

在 Windows 10 上，你可以创建一个 PowerShell 脚本来自动为当前 Git 仓库添加安全目录。这个脚本会处理路径格式转换问题，并适用于多个仓库。



## PowerShell 脚本解决方案

创建一个名为 `Add-SafeDirectory.ps1` 的脚本文件：

```powershell
# 获取当前 Git 仓库的根目录
$repoPath = git rev-parse --show-toplevel 2>$null

if (-not $repoPath) {
    Write-Host "当前目录不是 Git 仓库根目录或子目录" -ForegroundColor Red
    exit 1
}

# 将路径转换为适合 git config 的格式（正斜杠）
$safePath = $repoPath -replace '\\', '/'

# 添加安全目录
git config --global --add safe.directory "$safePath"

Write-Host "已添加安全目录: $safePath" -ForegroundColor Green
```

## 使用方法

1. 将上述脚本保存为 `Add-SafeDirectory.ps1`
2. 在 Git 仓库目录中打开 PowerShell
3. 运行脚本：`.\Add-SafeDirectory.ps1`

## 更便捷的全局使用方法

如果你想在任何地方都能使用这个脚本：

1. 将脚本保存到你的用户目录下的某个位置，比如 `C:\Users\YourName\scripts\`
2. 将该目录添加到系统 PATH 环境变量中
3. 然后你就可以在任何 Git 仓库中直接运行 `Add-SafeDirectory` 命令了

## 批处理版本（备用）

如果你更喜欢使用传统的批处理脚本，可以创建一个 `add_safe_dir.cmd` 文件：

```batch
@echo off
for /f "delims=" %%i in ('git rev-parse --show-toplevel 2^>nul') do set "repoPath=%%i"

if "%repoPath%"=="" (
    echo 当前目录不是 Git 仓库根目录或子目录
    pause
    exit /b 1
)

set "safePath=%repoPath:\=/%"
git config --global --add safe.directory "%safePath%"

echo 已添加安全目录: %safePath%
pause
```

## 注意事项

1. 这些脚本需要在 Git 仓库目录或其子目录中运行
2. 脚本会自动检测当前仓库的根目录
3. 路径中的反斜杠会被自动转换为正斜杠，以满足 git config 的要求
4. 如果你使用的是 Git Bash，可以直接在 Git Bash 中运行类似的 Bash 脚本

这个解决方案可以让你一键添加当前仓库为安全目录，无需手动复制粘贴路径。

---

# Git Bash 一键添加安全目录的解决方案

既然你使用的是 Git Bash，我可以提供一个更简洁的 Bash 脚本来解决这个问题。Git Bash 使用 Unix 风格的路径，所以处理起来会更简单。

## 创建 Bash 脚本

在你的用户目录下创建 `.bashrc_safe_directory` 文件（或直接添加到现有的 `.bashrc` 中）：

```bash
# 添加到 ~/.bashrc 或单独创建文件后 source 它
function add_safe_directory() {
    # 获取当前 Git 仓库根目录
    local repo_path=$(git rev-parse --show-toplevel 2>/dev/null)
    
    if [ -z "$repo_path" ]; then
        echo -e "\033[31m错误：当前目录不是 Git 仓库\033[0m"
        return 1
    fi
    
    # 在 Git Bash 中路径已经是 Unix 格式
    git config --global --add safe.directory "$repo_path"
    echo -e "\033[32m已添加安全目录: $repo_path\033[0m"
}
```

## 使用方法

1. 将上述代码添加到你的 `~/.bashrc` 文件中
2. 执行 `source ~/.bashrc` 或重新打开 Git Bash
3. 在任何 Git 仓库目录中，只需运行：
   ```bash
   add_safe_directory
   ```

## 更简单的单行命令版本

如果你不想修改 `.bashrc`，可以直接在任何 Git 仓库中运行：

```bash
git config --global --add safe.directory "$(git rev-parse --show-toplevel)"
```

## 一次性修复所有现有仓库

如果你想一次性为所有现有的 Git 仓库添加安全目录（假设它们都在 `~/Projects/` 目录下）：

```bash
find ~/Projects -type d -name '.git' -exec sh -c 'git config --global --add safe.directory "${0%/.git}"' {} \;
```

## 注意事项

1. 这些命令需要在 Git 仓库目录或其子目录中运行
2. Git Bash 已经使用 Unix 风格的路径分隔符（正斜杠），所以不需要转换
3. 如果你在 Windows 资源管理器中右键使用 "Git Bash Here"，脚本会自动识别正确的仓库路径

这个解决方案充分利用了 Git Bash 的环境特性，比 Windows 原生的解决方案更加简洁。

---

# 错误原因及解决方案

## 错误原因

你遇到的错误信息表明：
```
fatal: detected dubious ownership in repository at 'K:/Projects/vitepress-theme-teek-docs-template'
'K:/Projects/vitepress-theme-teek-docs-template' is on a file system that does not record ownership
```

这个错误是由于：
1. Git 的安全机制检测到仓库所在的文件系统（K:盘）无法正确记录文件所有权信息（常见于网络驱动器、外接硬盘或某些Windows配置）
2. Git 默认不信任这种无法确定所有权的仓库，以防止潜在的安全风险

## 解决方案

### 方法1：直接运行Git建议的命令（推荐）

错误信息中已经给出了解决方案：
```bash
git config --global --add safe.directory K:/Projects/vitepress-theme-teek-docs-template
```

### 方法2：使用修正后的脚本

修改之前的脚本，避免使用`git rev-parse`来获取路径（因为它在不被信任的仓库中会失败）：

```bash
function add_safe_directory() {
    # 使用pwd获取当前目录（Git Bash已自动转换路径格式）
    local repo_path=$(pwd)
    
    git config --global --add safe.directory "$repo_path"
    echo -e "\033[32m已添加安全目录: $repo_path\033[0m"
}
```

### 方法3：禁用安全检查（不推荐）

如果你完全信任这台电脑上的所有仓库，可以临时禁用这个检查：
```bash
git config --global --unset-all safe.directory
git config --global --add safe.directory "*"
```

⚠️ 警告：这会允许所有仓库，降低安全性，仅推荐在完全信任的环境中使用

## 最佳实践建议

1. **推荐使用方法1**：精确添加需要信任的目录
2. 如果K:是网络驱动器，考虑将仓库放在本地磁盘（如C:盘）可能会避免这个问题
3. 如果是公司/团队共享项目，确保所有协作者都添加了相同的安全目录配置

## 为什么之前的命令会失败？

因为`git rev-parse --show-toplevel`本身就需要访问Git仓库，但在仓库未被标记为安全前，Git会拒绝执行这个命令，形成了"先有鸡还是先有蛋"的问题。

---

这个错误是因为路径中的换行导致 Git Bash 将命令截断了。在 Git Bash 中，当路径太长时可能会自动换行，但直接复制粘贴会导致命令不完整。

## 正确的解决方法

### 方法1：使用引号包裹完整路径

```bash
git config --global --add safe.directory "K:/Projects/vitepress-theme-teek-docs-template"
```

### 方法2：使用相对路径（更简单）

既然你已经在仓库目录中，可以直接使用：

```bash
git config --global --add safe.directory "$(pwd)"
```

### 方法3：使用自动补全

输入以下命令后按 Tab 键自动补全路径：

```bash
git config --global --add safe.directory K:/Pro<Tab>
```

（按 Tab 键会自动补全剩余路径）

## 为什么会出现这个问题？

1. 你的路径中有换行（可能是终端自动换行导致的）
2. 没有用引号包裹包含空格的路径
3. 直接复制粘贴时包含了换行符

## 验证是否成功

添加后可以检查：

```bash
git config --global --get-all safe.directory
```

应该能看到你添加的路径。

---