跳至内容

Overlay

Overlay 是官方 Portage 树之外的软件来源——叠加上去，就能装到官方源里没有的包。gentoo-zh 是其中历史悠久的一个：前身是 2003 年的 gentoo-tw 与随后的 gentoo-china，两岸社区合并而来，源码在 GitHub。

到现在 gentoo-zh 收录了 450 多个软件包，大致这么几类：

  • 中文 / CJK：fcitx 输入法和一大堆插件、码表（rime、chinese-addons 等），搜狗 / 萌娘 / zhwiki 拼音词库，中文字体，以及一些软件的 CJK 补丁
  • 网络、开发工具等官方源里还没有的：毕竟是 gentoo 用户，谁手里没几个自己维护的包
  • 打好补丁的桌面 / 性能向内核：cachyos-sources、xanmod、liquorix 这些
  • 跟进新版本：官方源暂时没人管的包，这边接着出新版
  • 错误修复：开发者踩到 bug，解决后第一时间把补丁推回源里

规矩就一条：别弄坏别人的系统。每个 ebuild 进源前都得在它支持的架构上测过。

添加 gentoo-zh

用 eselect repository 启用最省事（先装好 app-eselect/eselect-repository）：

eselect repository enable gentoo-zh
emerge --sync gentoo-zh
手动配置（不想用 eselect）

在 /etc/portage/repos.conf/ 下创建 gentoo-zh.conf：

[gentoo-zh]
location = /var/db/repos/gentoo-zh
sync-type = git
sync-uri = https://github.com/microcai/gentoo-zh.git
auto-sync = yes

然后 emerge --sync gentoo-zh。

2025 年 10 月起官方不再为第三方仓库提供缓存镜像，gentoo-zh 改为直接从 GitHub 上游同步。之前添加过的用户需更新同步源，见 这篇说明。

国内镜像加速

直连 GitHub 或官方 distfiles 偏慢时，把 gentoo-zh 换成国内镜像。下面都已实测可用，整理自 peeweep 的公告，感谢！

git 同步源

把 overlay 的同步源切到国内镜像（gentoo-zh 是 microcai/gentoo-zh 的完整 ebuild 镜像，只含 ebuild、不含源码）。可用地址：

  • 重庆大学：https://mirrors.cqu.edu.cn/git/gentoo-zh.git
  • 南京大学：https://mirror.nju.edu.cn/git/gentoo-zh.git

第一次添加（先装好 git）：

sudo emerge -aq dev-vcs/git          # 没装 git 先装
rm -rf /var/db/repos/gentoo-zh       # 同步过的话先清掉旧的
eselect repository add gentoo-zh git https://mirrors.cqu.edu.cn/git/gentoo-zh.git
emerge --sync gentoo-zh

已经添加过的，把 /etc/portage/repos.conf/gentoo-zh.conf 里的 sync-uri 改成上面任一地址即可。

distfiles 缓存

加速软件包源码下载。源站 https://distfiles.gentoocn.org/，可用镜像：

  • 重庆大学：https://mirrors.cqu.edu.cn/gentoo-zh/
  • 南京大学：https://mirror.nju.edu.cn/gentoo-zh

在 /etc/portage/make.conf 的 GENTOO_MIRRORS 里，官方源之后追加：

GENTOO_MIRRORS="${GENTOO_MIRRORS} https://distfiles.gentoocn.org"
不想 mirror 某些 distfiles（版权等原因）时，在对应 ebuild 里加 RESTRICT="mirror"。

用 overlay 里的包

gentoo-zh 的包都是 ~arch（测试）关键字、不收 stable。已经在跑 ~amd64（测试分支）的系统直接 emerge 即可；稳定分支的系统安装前要先为这些包接受测试关键字。

按需放行你要装的包（推荐，只接受用到的）：

echo "app-foo/bar ~amd64" >> /etc/portage/package.accept_keywords/gentoo-zh
emerge --ask app-foo/bar

或放行整个 overlay（省事，但会一并引入更多测试包，自行取舍）：

echo "*/*::gentoo-zh ~amd64" >> /etc/portage/package.accept_keywords/gentoo-zh

看 overlay 提供了哪些包：eix -RO gentoo-zh。

参与贡献

欢迎给 gentoo-zh 添砖加瓦：到 GitHub 仓库 提 Pull Request，发现问题也欢迎提 issue。