([\s\S]*?)<\/pre><\/td><\/tr><\/table><\/figure>/g,
    function(match, code) {
      // Extract plain text from the code
      const plainCode = code
        .replace(//g, '')
        .replace(/<\/span>/g, '')
        .replace(/
/g, '\n')
        .trim();

      // Check if it looks like mermaid code
      const mermaidKeywords = ['graph', 'sequenceDiagram', 'classDiagram', 'stateDiagram', 'gantt', 'pie', 'flowchart', 'erDiagram', 'journey'];
      const isMermaid = mermaidKeywords.some(keyword => plainCode.startsWith(keyword));

      if (isMermaid) {
        return '
' + plainCode + '
';
      }

      return match;
    }
  );

  return data;
});
```

## 使用示例

### 流程图

```mermaid
graph TD
    A[开始] --> B{需要图表?}
    B -->|是| C[使用 Mermaid]
    B -->|否| D[纯文本描述]
    C --> E[完成]
    D --> E
```

### 时序图

```mermaid
sequenceDiagram
    participant 客户端
    participant 服务器
    participant 数据库

    客户端->>服务器: 发起请求
    服务器->>数据库: 查询数据
    数据库-->>服务器: 返回结果
    服务器-->>客户端: 响应数据
```

### 甘特图

```mermaid
gantt
    title 项目计划
    dateFormat YYYY-MM-DD
    section 开发
    功能开发    :2025-01-01, 5d
    代码审查    :2025-01-06, 2d
    section 测试
    测试验证    :2025-01-08, 3d
```

## 配置说明

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| `mermaid_enable` | 是否启用 Mermaid | `false` |
| `mermaid_version` | Mermaid 版本号 | `"11"` |

**版本配置示例**：
- `"11"` - 使用 11.x 最新版
- `"10.9.0"` - 使用指定版本

## 主题适配说明

本方案由三部分组成：

1. **主题配置**：在主题的 `_config.yml` 中添加开关和版本配置
2. **脚本加载**：在主题的 `head` 模板中添加 CDN 脚本（**需要适配主题**）
3. **HTML 转换**：`scripts/mermaid-renderer.js` 脚本（**通用，无需修改**）

如果你使用的不是 Frame 主题，只需要调整步骤 1 和步骤 2 的文件路径，步骤 3 的脚本完全通用。

## 注意事项

- Hexo 脚本修改后需重启 `hexo server`
- Mermaid 代码块会自动识别关键字（`graph`、`sequenceDiagram` 等）
- 如需关闭渲染，设置 `mermaid_enable: false`

更多图表语法参考 [Mermaid 官方文档](https://mermaid.js.org/)。]]>
            yupanzi
            Hexo
            Mermaid
            Visualization
        
        
            
            https://yupanzi.com/posts/claude-code-configuration/
            https://yupanzi.com/posts/claude-code-configuration/
            Fri, 10 Oct 2025 14:30:37 GMT
            
             ~/.claude/config.json
```

**Windows:**

```powershell
New-Item -ItemType Directory -Force -Path "$HOME\.claude"
Set-Content -Path "$HOME\.claude\config.json" -Value '{"primaryApiKey": "your-api-key"}'
```

重启 VS Code 后，点击活动栏的 Claude 图标即可开始使用。

---

## Codex CLI

### 安装

```bash
npm install -g @openai/codex
```

### 配置文件

| 系统 | 路径 |
|------|------|
| Windows | `%USERPROFILE%\.codex\config.toml` |
| macOS/Linux | `~/.codex/config.toml` |

写入配置：

```toml
model = "gpt-5"
model_provider = "openai-chat-completions"

[model_providers.openai-chat-completions]
name = "PROXY"
base_url = "https://api.example.com/v1"
env_key = "PROXY_OPENAI_API_KEY"
wire_api = "chat"
```

### 设置环境变量

Codex 需要额外配置环境变量：

**Windows:**

```powershell
# 临时
$env:PROXY_OPENAI_API_KEY = "sk-xxxx"

# 永久
[System.Environment]::SetEnvironmentVariable('PROXY_OPENAI_API_KEY', 'sk-xxxx', 'User')
```

**macOS/Linux:**

```bash
# 临时
export PROXY_OPENAI_API_KEY="sk-xxxx"

# 永久
echo 'export PROXY_OPENAI_API_KEY="sk-xxxx"' >> ~/.bashrc  # 或 ~/.zshrc
source ~/.bashrc
```

---

## Gemini CLI

### 安装

```bash
npm install -g @google/gemini-cli
```

### 配置方式

Gemini 没有专门的配置文件，使用环境变量或 `.env` 文件。

**方法一：.env 文件**

```bash
# Windows: notepad $env:USERPROFILE\.env
# macOS/Linux: vim ~/.env

GOOGLE_GEMINI_BASE_URL=https://api.example.com/gemini
GEMINI_API_KEY=sk-xxxx
GEMINI_MODEL=gemini-2.5-pro
```

**方法二：环境变量**

Windows:

```powershell
[System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_BASE_URL', 'https://api.example.com/gemini', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'sk-xxxx', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_MODEL', 'gemini-2.5-pro', 'User')
```

macOS/Linux:

```bash
cat >> ~/.bashrc << 'EOF'
export GOOGLE_GEMINI_BASE_URL=https://api.example.com/gemini
export GEMINI_API_KEY=sk-xxxx
export GEMINI_MODEL=gemini-2.5-pro
EOF

source ~/.bashrc
```

---

## 工具对比

| 工具 | 配置方式 | 环境变量 | 难度 |
|------|---------|---------|------|
| Claude Code CLI | JSON 配置文件 | 不需要 | 简单 |
| Claude Code 插件 | VS Code 设置 + JSON | 不需要 | 简单 |
| Codex | TOML 配置 + 环境变量 | 需要 | 中等 |
| Gemini CLI | 环境变量或 .env | 需要 | 简单 |

---

## 注意事项

### API Key 安全

把配置文件加到 `.gitignore`：

```
.env
settings.json
config.toml
```

### 文件权限

**macOS/Linux:**

```bash
chmod 600 ~/.claude/settings.json
chmod 600 ~/.codex/config.toml
chmod 600 ~/.env
```

**Windows:**

```powershell
icacls "$env:USERPROFILE\.claude\settings.json" /inheritance:r /grant:r "$env:USERNAME:F"
```

### 环境变量持久化

| 系统 | 配置文件 |
|------|----------|
| Windows | 系统环境变量或 `$PROFILE` |
| macOS | `~/.zshrc`（默认 Zsh） |
| Linux | `~/.bashrc` 或 `~/.zshrc` |

### 常见问题

| 问题 | 解决方案 |
|------|----------|
| 找不到配置目录 | 手动创建：`mkdir ~/.claude` |
| 环境变量不生效 | Windows 重启终端，macOS/Linux 执行 `source ~/.bashrc` |
| 切换不同 API | Codex 可配多个 `model_providers`，修改 `model_provider` 字段 |

---

## 使用建议

- **推荐**：命令行版 Claude Code 比 VS Code 插件更好用
- 如果使用官方服务，直接登录更方便，不需要这些自定义配置
- Codex 支持多 provider 切换，适合需要在不同 API 间切换的场景

## 参考资料

- [Claude Code 官方文档](https://docs.anthropic.com/en/docs/claude-code)
- [CSDN - Claude Code 配置教程](https://blog.csdn.net/weixin_49869937/article/details/152317666)]]>
            yupanzi
            AI
            Claude
            VSCode
            Codex
            Gemini
        
        
            
            https://yupanzi.com/posts/nginx-reverse-proxy-ssl-expired-k8s/
            https://yupanzi.com/posts/nginx-reverse-proxy-ssl-expired-k8s/
            Fri, 10 Oct 2025 10:18:12 GMT
            
            
            yupanzi
            Helm
            Kubernetes
            Network
            Nginx
        
        
            
            https://yupanzi.com/posts/how-to-start-database-proxy/
            https://yupanzi.com/posts/how-to-start-database-proxy/
            Sun, 29 Sep 2024 15:34:32 GMT
            
            
            yupanzi
            Database
            Network
            Nginx
        
        
            
            https://yupanzi.com/posts/docker-private-services/
            https://yupanzi.com/posts/docker-private-services/
            Sun, 29 Sep 2024 15:11:40 GMT
            
             $BACKUP_DIR/ldap-$DATE.ldif

# Vaultwarden
tar -czf $BACKUP_DIR/vault-$DATE.tar.gz ~/vaultwarden

# 清理 30 天前的备份
find $BACKUP_DIR -name "*.tar.gz" -mtime +30 -delete
```

### SSL 证书

使用 Let's Encrypt 自动证书：

```bash
certbot certonly --nginx -d repo.example.com -d jenkins.example.com -d vault.example.com
```

---

## 参考资料

- [Nexus 官方文档](https://help.sonatype.com/)
- [Jenkins 反向代理配置](https://www.jenkins.io/doc/book/system-administration/reverse-proxy-configuration-nginx/)
- [OpenLDAP Docker 镜像](https://github.com/osixia/docker-openldap)
- [Vaultwarden Wiki](https://github.com/dani-garcia/vaultwarden/wiki)]]>
            yupanzi
            Docker
            CI/CD
            DevOps
        
        
            
            https://yupanzi.com/posts/authentik-oauth-integration/
            https://yupanzi.com/posts/authentik-oauth-integration/
            Fri, 31 May 2024 14:22:19 GMT
            
            
            yupanzi
            Authentication
            OAuth2
            Authentik
        
        
            
            https://yupanzi.com/posts/sentry-k8s-deployment/
            https://yupanzi.com/posts/sentry-k8s-deployment/
            Fri, 31 May 2024 09:58:29 GMT
            
            
            yupanzi
            Database
            Helm
            Kubernetes
        
        
            
            https://yupanzi.com/posts/fibonacci-sequence-time-complexity/
            https://yupanzi.com/posts/fibonacci-sequence-time-complexity/
            Thu, 16 May 2024 16:34:22 GMT
            
             0:
        if n % 2 == 1:
            result = matrix_multiply(result, matrix)
        matrix = matrix_multiply(matrix, matrix)
        n //= 2
    return result

def fibonacci_matrix(n):
    if n <= 1:
        return n
    matrix = [[1, 1], [1, 0]]
    powered_matrix = matrix_power(matrix, n-1)
    return powered_matrix[0][0]
```

**原理**：利用 `[[1,1],[1,0]]^n` 的性质快速计算。

## Binet 公式

使用黄金分割比直接计算：

```python
import math

def fibonacci_binet(n):
    sqrt_5 = math.sqrt(5)
    phi = (1 + sqrt_5) / 2  # 黄金分割比
    return round((phi**n - (-1/phi)**n) / sqrt_5)
```

## 注意事项

- **递归方法**仅适合小数值，`n > 40` 时会非常慢
- **动态规划**是实际工作中最常用的方法，平衡了效率和易读性
- **矩阵快速幂**适合需要计算超大数值的场景
- **Binet 公式**在 `n` 很大时会因浮点数精度问题产生误差]]>
            yupanzi
            Algorithm
            Python
        
        
            
            https://yupanzi.com/posts/base64-create-different/
            https://yupanzi.com/posts/base64-create-different/
            Thu, 16 May 2024 16:23:13 GMT
            
            
            yupanzi
            Algorithm
            Python
            Shell
        
        
            
            https://yupanzi.com/posts/git-cicd-tips/
            https://yupanzi.com/posts/git-cicd-tips/
            Thu, 16 May 2024 16:17:56 GMT
            
             参考: [Ruby China - git pull 和 git fetch 有什么区别](https://ruby-china.org/topics/15729)

---

## Rebase vs Merge

### Merge（合并）

- 创建新的合并提交
- 保留非线性历史
- 保持完整的分支记录
- 适合公共分支间合并

### Rebase（变基）

- 重写提交历史
- 创建线性历史
- 看起来像顺序开发
- 适合特性分支更新

### 使用原则

| 原则 | 说明 |
|------|------|
| 公共分支用 merge | 不要在公共分支（main/develop）上 rebase |
| 特性分支用 rebase | 更新特性分支或准备合并到主分支 |
| 团队统一规范 | 确保团队理解并遵守相同的工作流程 |
| 操作前备份 | rebase 前创建备份分支或推送到远程 |

---

## 切换默认分支（main → master）

### 1. 创建并推送 master 分支

```bash
# 从 main 创建 master
git branch master main

# 推送到远程
git push origin master
```

### 2. 在远程仓库更改默认分支

- **GitHub**: Settings → Branches → Default branch → 选择 master
- **GitLab**: Settings → Repository → Default Branch → 选择 master
- **Bitbucket**: Repository settings → Branches → Main branch → 选择 master

### 3. 删除旧的 main 分支（可选）

```bash
# 切换到 master
git checkout master

# 删除本地 main
git branch -d main

# 删除远程 main
git push origin --delete main
```

**注意**：更改默认分支会影响其他开发者和 CI/CD，需提前通知团队。

---

## 分支同步（develop → master）

### 方法一：Reset（重置，丢弃所有修改）

```bash
# 拉取最新 master
git checkout master
git pull origin master

# 重置 develop 到 master
git checkout develop
git reset --hard origin/master
```

**警告**：会丢弃 develop 上所有不在 master 的提交。

### 方法二：Merge（合并，保留历史）

```bash
git checkout develop
git merge master
```

保留 develop 的提交历史，将 master 的更改合并进来。

### 方法三：Rebase（变基，线性历史）

```bash
git checkout develop
git rebase master
```

将 develop 的更改重新应用到 master 之上，可能产生冲突。

### 方法四：重建分支（彻底同步）

```bash
git checkout master
git branch -D develop           # 删除旧 develop
git checkout -b develop         # 基于 master 创建新 develop
git push -f origin develop      # 强制推送
```

**警告**：强制推送会重写远程历史，需与团队沟通。

### 安全建议

操作前创建备份：

```bash
git checkout develop
git branch backup_develop  # 创建备份分支
```

出现问题时可用备份恢复。

---

## GitLab CI/CD 并行执行

### 并行执行原理

GitLab CI/CD 中，同一个 stage 的多个 job 默认会并行执行（前提是有足够的 Runner）。

### 方法一：同一 Stage 多个 Job

```yaml
stages:
  - build
  - test

job1:
  stage: build
  script:
    - echo "This is job1"

job2:
  stage: build
  script:
    - echo "This is job2"

test1:
  stage: test
  script:
    - echo "This is test1"

test2:
  stage: test
  script:
    - echo "This is test2"
```

- `job1` 和 `job2` 在 `build` 阶段并行执行
- `test1` 和 `test2` 在 `test` 阶段并行执行

### 方法二：使用 parallel 关键字

将单个作业分成多个并行实例：

```yaml
test:
  stage: test
  script:
    - echo "This is a parallel test"
  parallel: 3
```

这会启动 3 个并行的 `test` 作业实例。

### Runner 并发配置

确保 GitLab Runner 支持并发执行。

在 Runner 配置文件中设置 `concurrent` 值：

```toml
concurrent = 10
```

如果并发数设置过低，作业会排队等待，无法真正并行。

### 注意事项

- 并行执行需要足够的可用 Runner
- Runner 的 `concurrent` 值决定了最大并发作业数
- 不同 stage 之间是串行执行的
- 使用 `parallel` 关键字可以水平扩展单个作业]]>
            yupanzi
            Git
            CI/CD
            GitLab
        
        
            
            https://yupanzi.com/posts/authentik-use-dingtalk-login/
            https://yupanzi.com/posts/authentik-use-dingtalk-login/
            Wed, 10 Apr 2024 13:44:53 GMT
            
            
接口示例

```text
钉钉 OAuth2 协议流程

1. 授权请求
GET https://login.dingtalk.com/oauth2/auth?
redirect_uri=https%3A%2F%2Fwww.example.com%2F&response_type=code&client_id=dingyourclientid&scope=openid&prompt=consent

2. 回调地址格式
https://www.example.com/?authCode=6b427e8bfab83e93bedd13f16a430702

3. 获取 Token
POST https://api.dingtalk.com/v1.0/oauth2/userAccessToken
Content-Type: application/json

{
  "clientId": "ding your id",
  "clientSecret": "your secret",
  "code": "6b427e8bfab83e93bedd13f16a430702",
  "grantType": "authorization_code"
}

响应：
{
  "expireIn": 7200,
  "accessToken": "a8f4e3215a703ce9a7164e91dbab53c0",
  "refreshToken": "b13e5a61b421342d95d86c9e64c275c6"
}

4. 获取用户信息
GET https://api.dingtalk.com/v1.0/contact/users/me
x-acs-dingtalk-access-token: a8f4e3215a703ce9a7164e91dbab53c0
Content-Type: application/json

响应：
{
  "nick": "AWIS ME",
  "unionId": "D578iS5hxxxx",
  "avatarUrl": "https://static-legacy.dingtalk.com/media/lADPGT5i9m5ZyXDNA4LNAtA_720.jpg",
  "openId": "WySPOpXqxE",
  "mobile": "1350xxxxxxxx",
  "stateCode": "86",
  "email": "xxxu@xxx.com"
}
```



**参考实现：**
- [Directus 讨论示例](https://github.com/directus/directus/discussions/11881)
- [apiproxy 实现](https://github.com/xu4wang/apiproxy/blob/main/src/handlers/oauth_dingtalk.ts)
- [Kratos 实现](https://github.com/ory/kratos/blob/eb67bed1f26d2c7ff10e5481b679b2213b44676d/selfservice/strategy/oidc/provider_dingtalk.go)

### 2. 配置 Authentik

参考：[Twitch 集成文档](https://docs.goauthentik.io/integrations/sources/twitch/)

**关键配置项：**

| 配置项 | 值 |
|--------|-----|
| 身份验证类型 | OpenID Connect |
| Scopes | `openid` |
| Authorization URL | `https://login.dingtalk.com/oauth2/auth?prompt=consent` |
| Token URL | 自定义转换服务 URL（见下文） |
| User Info URL | 自定义转换服务 URL（见下文） |

> **注意**：钉钉的 OAuth2 接口是非标准的（命名方法和参数格式有差异），需要自己实现转换服务。参考：[知乎文章](https://zhuanlan.zhihu.com/p/666423994)

### 3. 实现 OAuth2 转换服务

使用 AWS Serverless（Lambda）实现，将钉钉接口转换为标准 OAuth2 格式。

#### 3.1 Token 接口


📄 /auth/dingtalk/token

```python
import requests
import json
from base64 import b64decode
from urllib.parse import parse_qs

TOKEN_URL = 'https://api.dingtalk.com/v1.0/oauth2/userAccessToken'

def parse_form_data_to_json(form_data):
    parsed_data = parse_qs(form_data)
    result = {k: v[0] for k, v in parsed_data.items()}
    return result

def main(event, context):
    print(f"event:\n{event}")
    s = event.get("body")
    if event.get("isBase64Encoded") and s:
        s = b64decode(s).decode("utf-8")
    body = parse_form_data_to_json(s)

    headers = {"Content-Type": "application/json"}
    response = requests.post(TOKEN_URL, json={
        'clientId': body.get('client_id'),
        'clientSecret': body.get('client_secret'),
        'code': body.get('code'),
        'grantType': body.get('grant_type'),
    }, headers=headers)
    response.raise_for_status()
    res = response.json()

    result = {
        # 'refresh_token': res.get('refreshToken'),
        'access_token': res.get('accessToken'),
        'expires_in': res.get('expiresIn'),
        'token_type': 'Bearer',
    }

    return {"statusCode": 200, "body": json.dumps(result)}
```



#### 3.2 用户信息接口


📄 /auth/dingtalk/profile

```python
import requests
import json

URL = 'https://api.dingtalk.com/v1.0/contact/users/me'

def main(event, context):
    print(f"event:\n{event}")
    access_token = event.get('headers', {}).get('authorization', '')
    access_token = access_token.replace('Bearer ', '')
    print(access_token)

    headers = {
        "Content-Type": "application/json",
        'x-acs-dingtalk-access-token': access_token,
    }
    response = requests.get(URL, headers=headers)
    response.raise_for_status()
    user_info = response.json()
    print(user_info)

    result = {
        # 'issuer': userInfoURL,
        # 'picture': user_info.get('avatarUrl'),
        'sub': user_info['openId'],  # 关键字段，必须有
        'nickname': user_info['nick'],
        'name': user_info['nick'],
        'email': user_info['email']
    }
    return {"statusCode": 200, "body": json.dumps(result)}
```



## 常见问题

### 错误：Could not determine id.

**原因**：返回的用户信息中缺少 `sub` 字段。

**解决**：确保转换服务返回包含 `sub` 字段的 JSON，`sub` 通常对应钉钉的 `openId`。

**相关源码：**
- [OAuth 类型定义](https://github.com/goauthentik/authentik/blob/main/authentik/sources/oauth/types/oidc.py)
- [回调处理逻辑](https://github.com/goauthentik/authentik/blob/main/authentik/sources/oauth/views/callback.py#L59)

**错误日志示例：**

```json
{
  "auth_via": "unauthenticated",
  "domain_url": "example.com",
  "event": "Authentication Failure",
  "host": "example.com",
  "level": "warning",
  "logger": "authentik.sources.oauth.views.callback",
  "pid": 4721,
  "reason": "Could not determine id.",
  "request_id": "28a8d8818c63441da41051455c32d437",
  "schema_name": "public",
  "timestamp": "2024-04-09T10:30:48.464283"
}
```

## 总结

通过自定义转换服务，成功将钉钉的非标准 OAuth2 接口适配为 Authentik 可识别的标准格式，实现了钉钉登录集成。核心要点：

1. 钉钉接口参数命名与标准 OAuth2 不同（如 `clientId` vs `client_id`）
2. 必须在用户信息中返回 `sub` 字段
3. 使用 Serverless 服务作为中间层进行协议转换]]>
            yupanzi
            AWS
            Authentication
            OAuth2
            Python
        
        
            
            https://yupanzi.com/posts/chatgpt-help-s3-move-object/
            https://yupanzi.com/posts/chatgpt-help-s3-move-object/
            Thu, 21 Mar 2024 14:46:34 GMT
            
            
            yupanzi
            AWS
            Cloud
            Python
            S3
        
        
            
            https://yupanzi.com/posts/kubernetes-ops-guide/
            https://yupanzi.com/posts/kubernetes-ops-guide/
            Thu, 21 Mar 2024 09:25:03 GMT
            
            
            yupanzi
            Kubernetes
            JupyterHub
            LDAP
        
        
            
            https://yupanzi.com/posts/mobile-and-pc/
            https://yupanzi.com/posts/mobile-and-pc/
            Thu, 08 Feb 2024 11:27:48 GMT
            
            
            yupanzi
            thoughts
            productivity
        
        
            
            https://yupanzi.com/posts/network-diagnostic-tips/
            https://yupanzi.com/posts/network-diagnostic-tips/
            Wed, 03 Jan 2024 18:13:47 GMT
            
             /dev/tcp/192.168.1.100/3306"

# 检查返回值
if [ $? -eq 0 ]; then
    echo "端口 3306 开放"
else
    echo "端口 3306 关闭或超时"
fi
```

**使用 /dev/tcp (内置方法)**

不需要额外工具：

```bash
# Bash 内置 TCP 测试
(echo > /dev/tcp/192.168.1.100/3306) &>/dev/null && echo "开放" || echo "关闭"
```

### 编写测试脚本

```bash
#!/bin/bash

host="192.168.1.100"
port=3306
timeout=3

# 测试端口
if timeout $timeout bash -c "cat < /dev/null > /dev/tcp/$host/$port" 2>/dev/null; then
    echo "✓ $host:$port 可访问"
    exit 0
else
    echo "✗ $host:$port 不可访问"
    exit 1
fi
```

使用：

```bash
chmod +x test-port.sh
./test-port.sh
```

### 方法对比

| 方法 | 优点 | 缺点 | 适用场景 |
|------|------|------|----------|
| `nc` | 简单快速 | 需要安装 | 日常测试 |
| `telnet` | 通用性好 | 难以脚本化 | 交互式测试 |
| `nmap` | 功能强大 | 较慢，需要安装 | 批量扫描 |
| `/dev/tcp` | 无需工具 | 仅 Bash 支持 | 脚本中使用 |
| `timeout + /dev/tcp` | 内置 + 超时控制 | 语法复杂 | 生产脚本 |

### 安装工具

**CentOS/RHEL**

```bash
yum install nc nmap telnet
```

**Ubuntu/Debian**

```bash
apt-get install netcat nmap telnet
```

**macOS**

```bash
brew install netcat nmap telnet
```

### 注意事项

- `telnet` 连接成功后需要手动退出，不适合脚本
- `nc` 的 `-w` 参数可以设置超时时间
- `nmap` 扫描大量端口可能触发防火墙告警
- `/dev/tcp` 方法在某些受限环境下可能不可用
- 使用 `timeout` 命令避免无限等待]]>
            yupanzi
            Network
            Shell
            Troubleshooting
        
        
            
            https://yupanzi.com/posts/chatgpt-one-year/
            https://yupanzi.com/posts/chatgpt-one-year/
            Thu, 30 Nov 2023 12:00:00 GMT
            
            
            yupanzi
            AI
        
        
            
            https://yupanzi.com/posts/start-hexo-blog/
            https://yupanzi.com/posts/start-hexo-blog/
            Thu, 30 Nov 2023 08:00:00 GMT
            
            
            yupanzi
            Hexo
            Blog
        
        
            
            https://yupanzi.com/posts/aws-upload-file-size-limit/
            https://yupanzi.com/posts/aws-upload-file-size-limit/
            Wed, 10 Oct 2018 10:00:00 GMT
            
            
            yupanzi
            AWS
            boto3
        
        
            
            https://yupanzi.com/posts/macos-system-tips/
            https://yupanzi.com/posts/macos-system-tips/
            Wed, 10 Oct 2018 10:00:00 GMT
            
             **注意**：这是 Unix 规则，`chflags` 命令无法改变这类文件的可见性。

**情况 2：被隐藏标记隐藏**

用 `chflags` 命令取消隐藏标记：

```bash
# 取消隐藏（-R 表示递归处理文件夹）
chflags -R nohidden /path/to/file

# 重新隐藏
chflags hidden /path/to/file
```

### 注意事项

开启全局显示后，会看到很多系统和应用的内部文件（如 `.DS_Store`、`.Trash` 等），**操作时注意别误删或修改这些文件**。

---

## 禁用 .DS_Store 文件

### 什么是 .DS_Store

.DS_Store (Desktop Services Store) 是 macOS 系统用来存储文件夹的自定义属性的隐藏文件，比如文件图标的位置、文件夹视图设置或背景图片。这个文件在本地使用没什么问题，但在网络共享、Git 仓库或 USB 设备中可能会造成困扰。

详细信息请参考: [Wikipedia - .DS_Store](https://en.wikipedia.org/wiki/.DS_Store)

### 查询当前设置状态

在修改设置前，我们可以先查看当前的配置状态：

```bash
# 查询网络卷的 .DS_Store 禁用状态
defaults read com.apple.desktopservices DSDontWriteNetworkStores

# 查询 USB 设备的 .DS_Store 禁用状态
defaults read com.apple.desktopservices DSDontWriteUSBStores

# 如果返回 1 表示已禁用，0 或错误提示表示未禁用（默认）
```

### 禁用 .DS_Store 文件创建

**禁用网络卷上的 .DS_Store**

在网络共享文件夹（如 SMB、AFP、NFS）上禁用：

```bash
defaults write com.apple.desktopservices DSDontWriteNetworkStores -bool true
```

**禁用 USB 设备上的 .DS_Store**

在外接 USB 存储设备上禁用：

```bash
defaults write com.apple.desktopservices DSDontWriteUSBStores -bool true
```

**让设置生效**

修改设置后需要重启 Finder：

```bash
killall Finder
```

**注意**：macOS 目前**无法完全禁用本地磁盘**上的 .DS_Store 文件创建，这是系统 Finder 正常工作所必需的。上述命令只对网络卷和 USB 设备有效。

### 清理现有的 .DS_Store 文件

**清理特定目录**：

```bash
# 清理当前目录及子目录
find . -name ".DS_Store" -type f -delete

# 清理指定目录（将 /path/to/dir 替换为实际路径）
find /path/to/dir -name ".DS_Store" -type f -delete
```

**清理整个系统（需谨慎）**：

```bash
# 清理整个用户目录
find ~ -name ".DS_Store" -type f -delete

# 清理整个系统（需要 sudo 权限，执行前请三思）
sudo find / -name ".DS_Store" -depth -exec rm {} \;
```

### Git 仓库处理

如果你在使用 Git，建议将 .DS_Store 加入 `.gitignore`：

```bash
echo ".DS_Store" >> .gitignore
```

已经提交到仓库的 .DS_Store 可以这样移除：

```bash
# 从 Git 索引中删除，但保留本地文件
find . -name .DS_Store -print0 | xargs -0 git rm -f --ignore-unmatch --cached

# 提交更改
git commit -m "Remove .DS_Store files"
```

### 恢复默认设置

如果想恢复 macOS 的默认行为（允许创建 .DS_Store）：

```bash
# 恢复网络卷设置
defaults delete com.apple.desktopservices DSDontWriteNetworkStores

# 恢复 USB 设备设置
defaults delete com.apple.desktopservices DSDontWriteUSBStores

# 重启 Finder 使设置生效
killall Finder
```

### 适用版本

以上命令在 macOS 10.12 (Sierra) 及更高版本（包括最新的 macOS Sequoia 15.x）上均可正常使用。`defaults` 命令是 macOS 系统的标准配置工具，向后兼容性良好。

## 参考链接

- [Wikipedia - .DS_Store](https://en.wikipedia.org/wiki/.DS_Store)
- [How to disable the creation of .DS_Store files for Mac users folders](https://www.techrepublic.com/article/how-to-disable-the-creation-of-dsstore-files-for-mac-users-folders/)]]>
            yupanzi
            macOS
            Terminal
        
        
            
            https://yupanzi.com/posts/ssh-complete-guide/
            https://yupanzi.com/posts/ssh-complete-guide/
            Tue, 19 Jun 2018 10:00:00 GMT
            
            
            yupanzi
            SSH
            Linux
            Network
        
        
            
            https://yupanzi.com/posts/ubuntu-system-tips/
            https://yupanzi.com/posts/ubuntu-system-tips/
            Tue, 19 Jun 2018 10:00:00 GMT
            
            
            yupanzi
            Ubuntu
            Linux
        
        
            
            https://yupanzi.com/posts/container-troubleshooting/
            https://yupanzi.com/posts/container-troubleshooting/
            Tue, 10 Oct 2017 10:00:00 GMT
            
            
            yupanzi
            Docker
            Kubernetes
            Troubleshooting
        
        
            
            https://yupanzi.com/posts/emacs-tips/
            https://yupanzi.com/posts/emacs-tips/
            Tue, 10 Oct 2017 10:00:00 GMT
            
            
            yupanzi
            Emacs
            Editor