2025年Linux系统连接GitHub完全指南（从SSH密钥到GitHub CLI的终极配置）

一、准备工作：安装与配置Git

在开始连接之前，需要确保系统安装了Git。不同的Linux发行版安装命令略有不同：

• Debian/Ubuntu: sudo apt update && sudo apt install git -y -1
• CentOS/RHEL: sudo yum install git -y 或者使用dnf -2

安装完成后，需要配置全局的用户名和邮箱，这样你的提交才会正确显示作者信息：

    git config --global user.name "你的名字"git config --global user.email "你的邮箱@example.com"  

二、核心方法：配置SSH密钥连接GitHub

GitHub SSH配置是Linux下连接GitHub最经典且安全的方式。它能避免每次推送代码时输入密码的麻烦。

2.1 生成新的SSH密钥

打开终端，粘贴以下命令（将邮箱替换成你的GitHub注册邮箱）。推荐使用安全性更高的ed25519算法 -5：

    ssh-keygen -t ed25519 -C "你的邮箱@example.com"  

然后一直按回车键接受默认设置即可。如果系统提示需要设置密码短语（passphrase），可以直接跳过留空。

2.2 将公钥添加到GitHub账户

首先，在终端中查看并复制你刚生成的公钥：

    cat /.ssh/id_ed25519.pub  

然后，登录GitHub网站，在右上角点击头像，进入 Settings → SSH and GPG keys → 点击 New SSH key。给这个密钥起一个容易识别的标题（例如“我的Linux笔记本”），并将刚才复制的公钥内容粘贴到Key输入框中，最后点击 Add SSH key 保存 -9。

2.3 测试SSH连接

使用以下命令测试是否配置成功：

    ssh -T git@github.com  

如果是第一次连接，会收到一个警告，输入yes继续。如果看到类似 Hi 用户名! You"ve successfully authenticated... 的提示，就说明Linux连接GitHub成功了 -9。

三、现代方法：使用GitHub CLI连接

除了SSH，官方工具GitHub CLI使用教程部分介绍的这个工具可以让你直接在终端操作仓库，甚至无需打开浏览器。

3.1 安装GitHub CLI

对于Ubuntu/Debian用户，可以使用以下命令安装最新版：

    type -p curl >/dev/null || sudo apt install curl -ycurl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpgsudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpgecho "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/nullsudo apt updatesudo apt install gh -y  

CentOS用户则可以使用sudo dnf install gh。截至2025年底，GitHub CLI已更新至2.79.0+版本，对三角工作流等协作模式有更好的支持 -7-6。

3.2 通过CLI认证

安装完成后，运行登录命令：

    gh auth login  

按照提示选择：

• 选择账户类型：GitHub.com
• 认证协议：推荐选择SSH，这样后续操作可以和SSH密钥配置结合。
• 然后会生成一个代码，并让你在浏览器中完成认证。认证成功后，终端就会显示登录成功。

3.3 使用CLI操作仓库

认证之后，你就可以直接用CLI操作了。例如，直接在命令行创建一个新仓库并推送本地代码：

    mkdir myprojectcd myprojectgit initecho "# My Project" > README.mdgit add .git commit -m "Initial commit"gh repo create myproject --public --source=. --remote=origin --push  

这行命令会自动在GitHub上创建仓库，并将本地内容推送上去，非常方便 -1。

四、网络问题排查：代理与DNS

有时候，即使配置正确，也可能因为网络环境导致GitHub连接不上的解决方案变得复杂。如果你在“受限”的网络环境下使用，可以考虑设置代理。

4.1 为Git设置HTTP代理

如果使用HTTPS协议，可以为GitHub单独设置代理，不影响其他网站 -8：

    git config --global http.https://github.com.proxy http://127.0.0.1:10808  

4.2 为SSH设置代理

如果使用SSH协议，需要修改SSH配置文件 ~/.ssh/config：

    Host github.com  HostName github.com  ProxyCommand nc -X 5 -x 127.0.0.1:10808 %h %p  

此外，如果遇到证书错误，可以尝试同步系统时间或更新CA证书 -4。

五、总结

通过以上步骤，你应该能够在Linux上通过SSH或GitHub CLI顺畅地连接GitHub。这两种方法都是在2025年及未来值得推荐的最佳实践。记住，保护好你的私钥文件（~/.ssh/id_ed25519）至关重要。现在，去享受在命令行中自由驰骋的编程乐趣吧！