跳转至

实验室代码镜像

实验室在交叉楼 229 学生办公室提供 Gitea 代码托管服务。成员在办公室连接内网 Wi-Fi UULL311 后，可以通过 uull.git浏览和下载实验室代码镜像；离开该办公室内网后，域名可能无法解析或访问。

访问条件

  • 使用地点：交叉楼 229 学生办公室
  • 内网 Wi-Fi：UULL311
  • 服务地址：http://uull.git/

uull.git 仅面向上述办公室内网。镜像用于提高内网下载速度和集中查找代码，原仓库仍是历史、权限和发布状态的权威来源。

文档控制

项目 内容
文档编号 / 版本 UULL-GUIDE-GITEA-001 / 0.2
状态 草稿；镜像同步频率、失效处理和账号撤销流程待确认
适用范围 交叉楼 229 学生办公室内网的实验室 Gitea 镜像
维护联系人 / 最终确认人 邓宏健 / 邓宏健
最近确认日期 待填写
固定复核周期 每 12 个月；服务地址、网络、组织或镜像规则变化时立即复核

首次注册与加入组织

  1. 在交叉楼 229 学生办公室连接内网 Wi-Fi UULL311。
  2. 打开 http://uull.git/，在首次登录页面注册个人账号。
  3. 注册完成后，将自己的 Gitea 用户名发送给邓宏健。
  4. 由邓宏健按用户名邀请该账号加入 uull 组织；收到系统提示时完成加入。
  5. 登录后切换到 uull 组织，确认可以浏览组织内的代码镜像。

只发送用户名

申请加入组织时只需提供 Gitea 用户名，不要发送登录密码、访问令牌或其他凭据。

下载已有镜像

  1. 在交叉楼 229 学生办公室连接内网 Wi-Fi UULL311。
  2. 打开 http://uull.git/并登录。
  3. 切换到 uull 组织，按仓库名称查找所需代码。
  4. 在仓库页面复制 HTTP 克隆地址，或直接下载源码压缩包。

典型克隆地址形式如下，实际仓库名以页面显示为准：

git clone http://uull.git/uull/<repository>.git

镜像不是提交入口

除非仓库维护者另有说明，不要直接向镜像仓库提交代码。需要修改项目时，应前往页面标明的上游主仓库，按该项目的分支和审核流程操作。

无法访问时

  1. 确认当前位置为交叉楼 229 学生办公室，并且当前连接的 Wi-Fi 为 UULL311。
  2. 重新访问 http://uull.git/，判断是整个服务无法打开、账号无法登录，还是只有单个仓库异常。
  3. 账号无法登录、无法进入 uull 组织或服务持续不可用时，记录发生时间和页面错误提示后联系邓宏健。
  4. 只有单个仓库无法下载或同步时，同时提供仓库名称；不要发送密码、访问令牌或包含凭据的截图。

创建新的仓库镜像

创建权限

创建或迁移镜像前，应确认账号已经加入 uull 组织并具有仓库创建权限。无法选择 uull 作为拥有者或没有创建权限时，联系邓宏健处理；不要把实验室镜像创建在个人账户下。

1. 切换到组织

从左上角用户菜单切换到 uull 组织，确认后续创建的仓库归组织所有，而不是放在个人账户下。

在 Gitea 用户菜单中切换到 uull 组织
切换到 uull 组织，并确认右侧仓库列表属于该组织。

2. 开始创建仓库

在仓库列表右上角点击加号，新建或迁移仓库。

点击 Gitea 仓库列表右上角的加号
从仓库列表右上角进入创建仓库页面。

3. 选择迁移仓库

在“创建仓库”页面点击“迁移仓库”，不要手工创建一个与上游无关联的空仓库。

在创建仓库页面选择迁移仓库
选择迁移仓库，并确认拥有者为 uull。

4. 选择上游来源

根据上游平台选择 Git、GitHub、GitLab、Gitea 或其他对应来源。不确定时可选择“Git”，使用仓库的 HTTPS 克隆地址。

Gitea 迁移仓库时选择上游来源
选择与上游仓库匹配的来源类型。

5. 填写镜像信息

  1. 在“从 URL 迁移/克隆”中填写上游仓库的 HTTPS 或 Git 克隆地址。
  2. 只有上游需要认证时才填写用户名和访问令牌；优先使用权限最小、可撤销的只读令牌。
  3. 勾选“该仓库将是一个镜像”。
  4. 拥有者选择 uull，仓库名称保持简短并与上游一致。
  5. 根据上游可见范围设置镜像可见性，再点击“迁移仓库”。
填写上游仓库地址并启用镜像选项
填写来源、认证、拥有者和仓库名称，并启用镜像选项。

不要保存上游密码

不要把个人密码、访问令牌或其他凭据写入 Wiki、截图、仓库说明或代码。需要认证时优先使用只读访问令牌，并通过私下渠道确认令牌的保存位置和撤销方式。

创建后检查

  • 仓库归属为 uull/<repository>，而不是个人账户。
  • 默认分支、提交历史、标签和所需分支已经同步。
  • 仓库页面明确标识为镜像，上游地址正确。
  • 私有上游没有因迁移而被错误公开。
  • 在交叉楼学生办公室内网可以正常克隆或下载。
  • 后续同步失败时先检查上游地址和认证状态，不要删除已有镜像后盲目重建。

待确认的维护规则

  • 自动镜像的同步频率、失败通知和连续失败后的处理顺序。
  • 上游迁移、重命名、归档或删除时，内网镜像的保留和更新规则。
  • 成员离组后的账号、组织权限和个人访问令牌撤销流程。
  • 服务整体不可用时的恢复联系人、备份边界和状态通知渠道。

变更记录

版本 日期 说明 确认人
0.2 2026-08-12 增加文档控制、维护缺口和年度复核规则 待邓宏健确认