← Back to Skills Marketplace
thincher

github-dns-helper

by 要啥自行车 · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ⚠ suspicious
285
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install github-dns-helper
Description
GitHub DNS 修复助手。解决 GitHub 访问问题。当用户遇到 GitHub 无法访问、DNS 解析失败、连接超时等问题时使用此技能。
README (SKILL.md)

GitHub DNS Helper

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

使用方法

自动修复

直接运行脚本:

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

重要提示:

  • 首次使用需要配置 hosts 文件权限(只需一次)

  • 修改 hosts 文件需要管理员权限,请根据操作系统执行以下命令:

    检测操作系统:

    python3 -c "import platform; print(platform.system())"
    

    输出结果:WindowsDarwin (macOS) 或 Linux

    macOS:

    sudo chown $(whoami):staff /etc/hosts
    sudo chmod 644 /etc/hosts
    

    Linux:

    sudo chown $(whoami):$(whoami) /etc/hosts
    sudo chmod 644 /etc/hosts
    

    Windows:

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

    ⚠️ 此操作必须由用户在系统终端中手动执行 执行后,脚本将不再需要 sudo 权限,可以免密码运行

仅检查连接状态

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

使用自定义 hosts 源

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

查看帮助

python3 {{skill_path}}/scripts/fix_github_dns.py --help
Usage Guidance
This tool does what it says (it tries to fix GitHub connectivity by adding hosts entries), but it has two main risks you should consider before installing or running it: 1) Do not blindly change /etc/hosts ownership/permissions. The SKILL.md suggests chown/chmod so the script can run without sudo — this is unsafe. Prefer running the script with sudo only when needed, and avoid changing file ownership. Restoring proper root ownership and permissions is important for system security. 2) The script fetches hosts data from third‑party URLs (several proxies/mirrors are listed, including ghproxy/ghp.ci and a raw.hellogithub.com source). Hosts files can redirect domains to arbitrary IPs; if the fetched content is malicious, it can redirect github.com and related domains to attacker servers. Always inspect any fetched hosts content before applying it. Better: run the script in check mode (--check) to diagnose, fetch the hosts content manually (curl the URL), review the contents, and only then apply trusted, verified entries. Practical precautions: - Review the full script (including the truncated portion) before use to ensure there is no hidden exfiltration or network callbacks beyond obvious hosts fetching. - Do not run the suggested chown/chmod commands. Instead, run the script with sudo when writing /etc/hosts, or manually append vetted entries to /etc/hosts. - Prefer using official or well-known sources; avoid obscure proxy domains unless you trust them. Verify the IPs in any hosts list by independent means (e.g., known GitHub IP ranges, DNS over trusted resolvers). - Keep backups (the script already makes backups), and verify the backup files are correct before proceeding. If you do run the script, confirm you can restore /etc/hosts from backup and restore original ownership to root afterwards. - If you are unsure, run the tool in a disposable VM or container first. What would change this assessment: seeing the remainder of the script (truncated in the provided copy) to confirm there are no remote command executions, outbound callbacks, logging to external endpoints, or hidden exfiltration routines. If the rest of the script only formats/validates and writes vetted host entries, the risk is still present but more explainable (still proceed with caution).
Capability Analysis
Type: OpenClaw Skill Name: github-dns-helper Version: 1.0.3 The skill facilitates modifying the system's hosts file to resolve GitHub access issues but includes highly insecure instructions in SKILL.md that advise users to change the ownership of /etc/hosts to a non-root user (e.g., sudo chown $(whoami) /etc/hosts). This permanently weakens system security, allowing any user-level process to redirect network traffic without authentication. Additionally, the script scripts/fix_github_dns.py fetches host configurations from various third-party URLs (e.g., raw.hellogithub.com, ghproxy.com) and executes system commands via shell=True, posing risks of DNS hijacking if the sources are compromised or shell injection.
Capability Assessment
Purpose & Capability
The name/description, SKILL.md, and the included Python script all align: this tool tries to detect GitHub connectivity problems and update the system hosts file with entries fetched from remote hosts lists. That capability reasonably requires reading and writing the hosts file and performing network checks. However, the SKILL.md recommends changing /etc/hosts ownership/permissions so the script can run without sudo — that is unnecessary for the stated purpose and weakens system protections.
Instruction Scope
The SKILL.md instructs the user to run commands that change ownership and permissions of the system hosts file (macOS/Linux chown/chmod), and the script will fetch hosts content from arbitrary remote URLs and write it into /etc/hosts. Those instructions go beyond mere diagnostics: they instruct permanent changes to system file ownership/permissions and unconditional application of remote content. The script also allows arbitrary custom URLs for hosts data, which could be used to inject malicious entries that redirect GitHub domains to attacker IPs.
Install Mechanism
There is no remote install step; the skill is instruction‑only plus an included Python script. Nothing in the registry metadata downloads or executes code from unknown installers at install time. The script itself invokes curl/subprocess at runtime to fetch data, which is expected for this purpose.
Credentials
The skill does not request environment variables, credentials, or config paths. No unrelated secrets are declared or required.
Persistence & Privilege
While the skill does not request always:true or attempt to persist as an always-enabled skill, it explicitly instructs changing ownership/permissions of /etc/hosts so the script can run without sudo later. That reduces system protections and increases the long‑term blast radius of any malicious hosts entries. The script also writes to a system file (/etc/hosts), which requires elevated privileges and therefore broad system impact if abused.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install github-dns-helper
  3. After installation, invoke the skill by name or use /github-dns-helper
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Version 1.0.3 of github-dns-helper contains no file changes. - No updates or modifications detected in this release.
v1.0.2
Version 1.0.2 of github-dns-helper contains no file changes. - No updates or modifications detected in this version.
v1.0.1
- Improved instructions for configuring hosts file permissions, now with OS-specific steps for macOS, Linux, and Windows. - Added guidance to detect the operating system before applying permission commands. - Clarified that Windows users do not need to configure hosts file permissions, only run as administrator.
v1.0.0
- Initial release of GitHub DNS 修复助手 (github-dns-helper). - Helps resolve GitHub access issues, such as DNS failures and connection timeouts. - Provides an automated script to fix DNS by modifying the hosts file. - Includes instructions for required hosts file permissions and one-time setup. - Supports checking connectivity status and using custom hosts sources via command-line options.
Metadata
Slug github-dns-helper
Version 1.0.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is github-dns-helper?

GitHub DNS 修复助手。解决 GitHub 访问问题。当用户遇到 GitHub 无法访问、DNS 解析失败、连接超时等问题时使用此技能。 It is an AI Agent Skill for Claude Code / OpenClaw, with 285 downloads so far.

How do I install github-dns-helper?

Run "/install github-dns-helper" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is github-dns-helper free?

Yes, github-dns-helper is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does github-dns-helper support?

github-dns-helper is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created github-dns-helper?

It is built and maintained by 要啥自行车 (@thincher); the current version is v1.0.3.

💬 Comments