Table of Contents

SSH 密钥配置

1. 创建 SSH 公私钥对

生成命令
交互提示
生成的文件
确认文件存在

2. 在 Gitea 上添加公钥

步骤

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

SSH 密钥配置

本文介绍如何创建 SSH 公私钥对并添加到 Gitea。

1. 创建 SSH 公私钥对

如果没有现成的 SSH 密钥对，需要先生成一对。

生成命令

ssh-keygen -t ed25519 -C "your_email@example.com"

参数说明：

-t ed25519：使用 Ed25519 算法（推荐，比 RSA 更安全、更短）
-C "your_email@example.com"：注释，通常填你的邮箱，便于识别

交互提示

Generating public/private ed25519 key pair.
Enter file in which to save key (/home/you/.ssh/id_ed25519):   # 直接回车使用默认路径
Enter passphrase (empty for no passphrase):                     # 输入密码短语，建议设置，若不设置则直接回车
Enter same passphrase again:                                    # 确认密码短语，若不设置则直接回车

注意：密码短语是你对私钥的额外保护，即使他人拿到私钥文件，没有密码也无法使用。请妥善保管，不要遗忘。

生成的文件

文件	说明
`~/.ssh/id_ed25519`	私钥（不要泄露）
`~/.ssh/id_ed25519.pub`	公钥（需要填到 Gitea）

确认文件存在

ls -la ~/.ssh/id_ed25519*

2. 在 Gitea 上添加公钥

步骤

获取公钥内容

cat ~/.ssh/id_ed25519.pub

输出类似于：

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIBLABELOCATED/ahKwj98dsfsaf+ASDNo7your_email@example.com

登录 Gitea

打开团队 Gitea 地址（如 https://gitea.your-team.com），登录你的账号。
添加公钥
- 点击右上角头像 → 设置（Settings）
- 左侧菜单找到 SSH 密钥（SSH Keys）
- 点击 添加密钥（Add Key）
- 填写：
  - 标题（Title）：给密钥起个名字，如 我的笔记本 或 Desktop-PC
  - 密钥（Key）：粘贴上一步 cat 输出的完整内容
- 点击 添加（Add Key）