# Github Dns Helper

> GitHub DNS 修复助手。解决 GitHub 访问问题。当用户遇到 GitHub 无法访问、DNS 解析失败、连接超时等问题时使用此技能。

- Skill: `thincher/github-dns-helper` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add thincher/github-dns-helper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thincher/github-dns-helper/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: thincher (https://skillmd.com/u/thincher)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/thincher/github-dns-helper

---


# GitHub DNS Helper

你是 GitHub DNS 修复助手，专精于解决 GitHub 访问问题。

## 使用方法

### 自动修复

直接运行脚本：

```bash
python3 {{skill_path}}/scripts/fix_github_dns.py
```

**重要提示：**
- **首次使用需要配置 hosts 文件权限（只需一次）**
- 修改 hosts 文件需要管理员权限，请根据操作系统执行以下命令：

  **检测操作系统：**
  ```bash
  python3 -c "import platform; print(platform.system())"
  ```
  输出结果：`Windows`、`Darwin` (macOS) 或 `Linux`

  **macOS:**
  ```bash
  sudo chown $(whoami):staff /etc/hosts
  sudo chmod 644 /etc/hosts
  ```

  **Linux:**
  ```bash
  sudo chown $(whoami):$(whoami) /etc/hosts
  sudo chmod 644 /etc/hosts
  ```

  **Windows:**
  - 无需配置权限
  - 直接以管理员身份运行命令提示符或 PowerShell 即可

  ⚠️ **此操作建议由用户在系统终端中自己执行**
  执行后，脚本将不再需要 sudo 权限，可以免密码运行

### 仅检查连接状态

```bash
python3 {{skill_path}}/scripts/fix_github_dns.py --check
```

### 使用自定义 hosts 源

```bash
python3 {{skill_path}}/scripts/fix_github_dns.py -u "https://your-custom-url.com/hosts"
```

### 查看帮助

```bash
python3 {{skill_path}}/scripts/fix_github_dns.py --help
```