SHA256
Compare commits
2
Commits
53116f7a23
...
9446850182
| Author | SHA256 | Date | |
|---|---|---|---|
|
|
9446850182 | ||
|
|
8d5c8c6bae |
@@ -68,6 +68,7 @@ Gitea 把模板 / 语言 / 静态资源都编进了二进制,但读取时走 `as
|
|||||||
| 首页指向 | `[server] LANDING_PAGE` | `GITEA__server__LANDING_PAGE` |
|
| 首页指向 | `[server] LANDING_PAGE` | `GITEA__server__LANDING_PAGE` |
|
||||||
| meta 作者/描述/关键词 | `[ui.meta] AUTHOR/DESCRIPTION/KEYWORDS` | `GITEA__ui_0X2E_meta__DESCRIPTION` 等 |
|
| meta 作者/描述/关键词 | `[ui.meta] AUTHOR/DESCRIPTION/KEYWORDS` | `GITEA__ui_0X2E_meta__DESCRIPTION` 等 |
|
||||||
| 页脚 Powered by / 版本号 | `[other] SHOW_FOOTER_POWERED_BY` / `SHOW_FOOTER_VERSION` | `GITEA__other__SHOW_FOOTER_POWERED_BY` |
|
| 页脚 Powered by / 版本号 | `[other] SHOW_FOOTER_POWERED_BY` / `SHOW_FOOTER_VERSION` | `GITEA__other__SHOW_FOOTER_POWERED_BY` |
|
||||||
|
| Issue 显示姓名而非学号 | `[ui] DEFAULT_SHOW_FULL_NAME` | `GITEA__ui__DEFAULT_SHOW_FULL_NAME` |
|
||||||
| 自定义主题配色 | `[ui] THEMES` + `custom/public/assets/css/theme-*.css` | `GITEA__ui__THEMES` |
|
| 自定义主题配色 | `[ui] THEMES` + `custom/public/assets/css/theme-*.css` | `GITEA__ui__THEMES` |
|
||||||
| 关闭通行密钥(WebAuthn) | `[service] ENABLE_PASSKEY_AUTHENTICATION` | `GITEA__service__ENABLE_PASSKEY_AUTHENTICATION` |
|
| 关闭通行密钥(WebAuthn) | `[service] ENABLE_PASSKEY_AUTHENTICATION` | `GITEA__service__ENABLE_PASSKEY_AUTHENTICATION` |
|
||||||
| 关闭用户名/密码表单 | `[service] ENABLE_PASSWORD_SIGNIN_FORM` | `GITEA__service__ENABLE_PASSWORD_SIGNIN_FORM` |
|
| 关闭用户名/密码表单 | `[service] ENABLE_PASSWORD_SIGNIN_FORM` | `GITEA__service__ENABLE_PASSWORD_SIGNIN_FORM` |
|
||||||
@@ -260,6 +261,8 @@ GITEA_CUSTOM_DIR=../customization/custom
|
|||||||
GITEA__ui_0X2E_meta__KEYWORDS: 同济大学,高级语言程序设计,答疑,Issue
|
GITEA__ui_0X2E_meta__KEYWORDS: 同济大学,高级语言程序设计,答疑,Issue
|
||||||
GITEA__other__SHOW_FOOTER_POWERED_BY: "false"
|
GITEA__other__SHOW_FOOTER_POWERED_BY: "false"
|
||||||
GITEA__other__SHOW_FOOTER_VERSION: "false"
|
GITEA__other__SHOW_FOOTER_VERSION: "false"
|
||||||
|
# Issue 发布者/评论者显示姓名(导入时 full_name=姓名, login=学号)
|
||||||
|
GITEA__ui__DEFAULT_SHOW_FULL_NAME: "true"
|
||||||
```
|
```
|
||||||
|
|
||||||
设计取舍:
|
设计取舍:
|
||||||
@@ -365,6 +368,8 @@ cd deploy && ./scripts/backup.sh --quiesce && docker compose pull gitea && docke
|
|||||||
- ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框
|
- ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框
|
||||||
- ✅ 首页(登录后)顶部出现学期答疑入口卡片: 只认 `tjhlp-<5 位数字>`、取最新学期、
|
- ✅ 首页(登录后)顶部出现学期答疑入口卡片: 只认 `tjhlp-<5 位数字>`、取最新学期、
|
||||||
无匹配则不显示(预览里用 3 个用户 × 4 个组织验证过)
|
无匹配则不显示(预览里用 3 个用户 × 4 个组织验证过)
|
||||||
|
- ✅ 打开 `[ui] DEFAULT_SHOW_FULL_NAME` 后, Issue 的「由 X 创建」与正文/评论作者
|
||||||
|
显示 `full_name`(姓名), 未填姓名的用户回退显示 login(学号)(预览实测)
|
||||||
|
|
||||||
尚未覆盖(需要时按同样套路加):
|
尚未覆盖(需要时按同样套路加):
|
||||||
|
|
||||||
|
|||||||
@@ -84,6 +84,11 @@ services:
|
|||||||
GITEA__other__SHOW_FOOTER_POWERED_BY: "false"
|
GITEA__other__SHOW_FOOTER_POWERED_BY: "false"
|
||||||
GITEA__other__SHOW_FOOTER_VERSION: "false"
|
GITEA__other__SHOW_FOOTER_VERSION: "false"
|
||||||
|
|
||||||
|
# --- 显示名称: 与生产一致, Issue 显示姓名而不是学号 ----------------
|
||||||
|
# 说明见 deploy/compose.yaml 同位置。这里给上才能让预览里验证
|
||||||
|
# 「发布者/回答者显示姓名」的效果。
|
||||||
|
GITEA__ui__DEFAULT_SHOW_FULL_NAME: "true"
|
||||||
|
|
||||||
GITEA__log__MODE: console
|
GITEA__log__MODE: console
|
||||||
GITEA__log__LEVEL: ${GITEA_LOG_LEVEL:-info}
|
GITEA__log__LEVEL: ${GITEA_LOG_LEVEL:-info}
|
||||||
|
|
||||||
|
|||||||
+39
-1
@@ -885,7 +885,7 @@ systemctl start gitea`(§9)。
|
|||||||
| 配置 | 迁移前 | 现在 | 原因 |
|
| 配置 | 迁移前 | 现在 | 原因 |
|
||||||
|---|---|---|---|
|
|---|---|---|---|
|
||||||
| `log.MODE` | `file` | `console` | 日志进 stdout, 用 `docker compose logs` 收集 |
|
| `log.MODE` | `file` | `console` | 日志进 stdout, 用 `docker compose logs` 收集 |
|
||||||
| `server.DISABLE_SSH` | `false` | `true` | 实测 `/home/git/.ssh` 不存在, SSH 从未使用; 避免暴露无法工作的克隆地址 |
|
| `server.DISABLE_SSH` | `false` | `true` | 只提供 HTTP 克隆地址; 见下面的「如需启用 SSH 克隆」 |
|
||||||
| `server.DOMAIN` | `localhost` | 实际主机/IP | `localhost` 会生成错误的克隆地址; `ROOT_URL` 已显式指定, 此项属修正 |
|
| `server.DOMAIN` | `localhost` | 实际主机/IP | `localhost` 会生成错误的克隆地址; `ROOT_URL` 已显式指定, 此项属修正 |
|
||||||
| `security.ALLOWED_HOST_LIST` | `[security]`(**正确**) | **保持 `[security]`** | 1.27 的规范位置就是 `[security]`; `[webhook]` 是 v28.0.0 将移除的 deprecated fallback |
|
| `security.ALLOWED_HOST_LIST` | `[security]`(**正确**) | **保持 `[security]`** | 1.27 的规范位置就是 `[security]`; `[webhook]` 是 v28.0.0 将移除的 deprecated fallback |
|
||||||
| `server.HTTP_ADDR` | `0.0.0.0:2080` | 容器内 `0.0.0.0`, 宿主只发布 `127.0.0.1:2080` | 保持 Apache 反代路径不变, 同时消除直连暴露面 |
|
| `server.HTTP_ADDR` | `0.0.0.0:2080` | 容器内 `0.0.0.0`, 宿主只发布 `127.0.0.1:2080` | 保持 Apache 反代路径不变, 同时消除直连暴露面 |
|
||||||
@@ -894,6 +894,44 @@ systemctl start gitea`(§9)。
|
|||||||
其余配置(注册策略、OIDC 自动注册、admin 限制、pull-request/signing 默认值、
|
其余配置(注册策略、OIDC 自动注册、admin 限制、pull-request/signing 默认值、
|
||||||
`PASSWORD_HASH_ALGO=pbkdf2`、`OFFLINE_MODE`、webhook TLS 等)均按原值 1:1 保留。
|
`PASSWORD_HASH_ALGO=pbkdf2`、`OFFLINE_MODE`、webhook TLS 等)均按原值 1:1 保留。
|
||||||
|
|
||||||
|
#### 如需启用 SSH 克隆(可选, 默认关闭)
|
||||||
|
|
||||||
|
关闭后界面上所有克隆地址都是 HTTP, 加公钥时也会提示"SSH 目前已禁用, 这些密钥仅用于提交
|
||||||
|
签名验证"。实测现状(2026-09-23):
|
||||||
|
|
||||||
|
| 事实 | 值 |
|
||||||
|
|---|---|
|
||||||
|
| 镜像自带 sshd | **有**: s6 服务 `/etc/s6/openssh`, 容器内**已在 `0.0.0.0:22` 上监听**(只是没发布端口) |
|
||||||
|
| 发布到宿主 | 没有 —— `docker port gitea` 只有 `3000/tcp -> 127.0.0.1:2080`, 所以外部连不上 |
|
||||||
|
| git 用户家目录 | `/data/git`(不是旧版镜像的 `/home/git`) |
|
||||||
|
| 授权文件 | `/data/git/.ssh/authorized_keys`, **由 Gitea 维护**(形如 `command="… gitea serv key-N"`), 所以加过公钥的账号启用后立刻可用, 不用重加 |
|
||||||
|
| host key | `/data/ssh/ssh_host_{ed25519,rsa,ecdsa}_key`, 在 `/data` 持久卷里(迁移会一起走) |
|
||||||
|
| 认证策略 | `PasswordAuthentication no` / `AllowUsers git` / `PermitRootLogin no` / `AllowTcpForwarding,AllowAgentForwarding no` —— 只能公钥 |
|
||||||
|
| 宿主 22 | 被宿主自己的 OpenSSH 占着(`0.0.0.0:22`), 所以 Gitea 得换端口 |
|
||||||
|
|
||||||
|
要启用得同时改三处, 少一处就会出现 `ssh://git@localhost:22/...` 这种没用的克隆地址
|
||||||
|
(这正是当初关掉它的原因):
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
GITEA__server__DISABLE_SSH: "false"
|
||||||
|
GITEA__server__SSH_DOMAIN: ${GITEA_DOMAIN} # 对外主机; 默认值是 localhost
|
||||||
|
GITEA__server__SSH_PORT: "2222" # 展示在克隆地址里的端口
|
||||||
|
ports:
|
||||||
|
- "0.0.0.0:2222:22" # 宿主 2222 -> 容器 sshd 的 22
|
||||||
|
```
|
||||||
|
|
||||||
|
然后 `docker compose up -d gitea`(端口变了要重建容器), 验证:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ssh -T -p 2222 [email protected] # 期望: Hi <用户名>! You've successfully authenticated, ...
|
||||||
|
```
|
||||||
|
|
||||||
|
**代价**: 绕过 Apache 多开一个对外的口子(当前 firewalld 未运行 = 校内可达)、多一个攻击面、
|
||||||
|
`SSH_DOMAIN`/`SSH_PORT` 必须和实际一致、非 22 端口对使用者不友好。**好处**: 免密推送(私钥
|
||||||
|
不出本机), 而当前平台是纯 HTTP —— HTTP 推送的账号密码/token 是 base64 明文过网。
|
||||||
|
只需要给自己和几个助教免密的话, 用 HTTP + Personal Access Token +
|
||||||
|
`git config --global credential.helper 'cache --timeout=604800'` 更省事, 不必动服务器。
|
||||||
|
|
||||||
**迁移中发现并处理的既有问题**:
|
**迁移中发现并处理的既有问题**:
|
||||||
|
|
||||||
| # | 问题 | 证据 | 处理 |
|
| # | 问题 | 证据 | 处理 |
|
||||||
|
|||||||
+13
-2
@@ -92,6 +92,14 @@ services:
|
|||||||
GITEA__other__SHOW_FOOTER_POWERED_BY: "false"
|
GITEA__other__SHOW_FOOTER_POWERED_BY: "false"
|
||||||
GITEA__other__SHOW_FOOTER_VERSION: "false"
|
GITEA__other__SHOW_FOOTER_VERSION: "false"
|
||||||
|
|
||||||
|
# --- 显示名称: Issue 发布者/评论者显示姓名, 而不是学号 ---------------
|
||||||
|
# 导入用户时 full_name = 真实姓名、login = 学号(见 scripts/.../users.py);
|
||||||
|
# Gitea 默认只显示 login, 打开这个开关后 Issue 的「由 X 创建」、正文/评论作者
|
||||||
|
# 以及其它用 GetDisplayName() 的地方都改为显示 full_name, 没填姓名的回退学号。
|
||||||
|
# 证据: models/user/user.go 的 GetDisplayName(); templates/shared/user/authorlink.tmpl。
|
||||||
|
# 这是站点级设置, 没有按用户的开关。改完需重建容器(up -d)才生效。
|
||||||
|
GITEA__ui__DEFAULT_SHOW_FULL_NAME: "true"
|
||||||
|
|
||||||
# --- 数据库 ---------------------------------------------------------
|
# --- 数据库 ---------------------------------------------------------
|
||||||
GITEA__database__DB_TYPE: postgres
|
GITEA__database__DB_TYPE: postgres
|
||||||
GITEA__database__HOST: db:5432
|
GITEA__database__HOST: db:5432
|
||||||
@@ -108,8 +116,11 @@ services:
|
|||||||
GITEA__server__HTTP_ADDR: 0.0.0.0
|
GITEA__server__HTTP_ADDR: 0.0.0.0
|
||||||
GITEA__server__HTTP_PORT: "3000"
|
GITEA__server__HTTP_PORT: "3000"
|
||||||
GITEA__server__APP_DATA_PATH: /data/gitea
|
GITEA__server__APP_DATA_PATH: /data/gitea
|
||||||
# 现有部署未启用 SSH(git 用户无 .ssh/authorized_keys), 故关闭。
|
# 关闭 SSH: 界面只提供 HTTP 克隆地址(加公钥时会提示"仅用于提交签名验证")。
|
||||||
# 如需启用容器内置 SSH, 见 deploy/README.md "启用 SSH 克隆"。
|
# 注意镜像自带 sshd(s6 服务 openssh), 容器内就在 22 上监听 —— 只是没有发布端口。
|
||||||
|
# 启用要同时改 DISABLE_SSH / SSH_DOMAIN / SSH_PORT 并在 ports 里发布 2222:22,
|
||||||
|
# 少改一处就会出现 ssh://git@localhost:22/... 这种坏地址: 见
|
||||||
|
# deploy/README.md「如需启用 SSH 克隆(可选, 默认关闭)」。
|
||||||
GITEA__server__DISABLE_SSH: "true"
|
GITEA__server__DISABLE_SSH: "true"
|
||||||
GITEA__server__LFS_START_SERVER: "true"
|
GITEA__server__LFS_START_SERVER: "true"
|
||||||
GITEA__server__OFFLINE_MODE: ${GITEA_OFFLINE_MODE:-true}
|
GITEA__server__OFFLINE_MODE: ${GITEA_OFFLINE_MODE:-true}
|
||||||
|
|||||||
@@ -156,6 +156,20 @@ uv run tjhlp labels sync tjhlp-2025f/hw03
|
|||||||
uv run tjhlp webhooks list tjhlp-2025f/general
|
uv run tjhlp webhooks list tjhlp-2025f/general
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### 显示名维护(学号-姓名)
|
||||||
|
|
||||||
|
Issue 页显示的是 `full_name`。OIDC 登录时会把 `full_name` 覆盖成认证源
|
||||||
|
`FullNameClaimName` 对应的 claim(`display_name` = `学号-姓名`),因此**存量用户
|
||||||
|
需要重新登录**才会刷新。若不想等用户重登,用 `tools/fix_full_name.py` 直接刷一遍:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export TJHLP_GITEA_TOKEN=<token> # 或建 scripts/.secrets.toml
|
||||||
|
uv run python tools/fix_full_name.py # dry-run,只打印
|
||||||
|
uv run python tools/fix_full_name.py --apply # 实际写入
|
||||||
|
```
|
||||||
|
|
||||||
|
脚本只改 `full_name`(成 `学号-姓名`),不动用户名/邮箱和团队归属;默认跳过 `admin`。
|
||||||
|
|
||||||
### 学期结束清理
|
### 学期结束清理
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
[default.gitea]
|
[default.gitea]
|
||||||
url = "http://10.80.42.185:3000"
|
url = "http://127.0.0.1:2080"
|
||||||
# 同学实际访问的平台地址(Apache 反代 /QA -> 127.0.0.1:2080)。
|
# 同学实际访问的平台地址(Apache 反代 /QA -> 127.0.0.1:2080)。
|
||||||
# 用于 Issue Template 等面向用户的链接; url 只用于 CLI 调 API。
|
# 用于 Issue Template 等面向用户的链接; url 只用于 CLI 调 API。
|
||||||
public_url = "https://cpp.tongji.sh/QA"
|
public_url = "https://cpp.tongji.sh/QA"
|
||||||
|
|||||||
Reference in New Issue
Block a user