前書き
RTL8127がカーネルドライバに組み込まれたのは6.16系から
安価で低発熱なRealtek製RTL8127ですが、Linuxだと6.16より前のカーネルではDKMSドライバをインストールする必要があります。
6.16からr8169にRTL8127系チップのサポートが始まり、カーネル7.0以降でSFP+版チップ(細かくチップ型番を言うとRTL8127ATFのこと)にも対応しているようです。
Debian13では
カーネル6.12系であるDebian13では、DKMSドライバを当てる必要があります。
しかしRealtekのドライバには悪名高いクソ仕様があります。
今回はその悪名高いクソ仕様と格闘して解決した話です。
そも論
Realtek公式サイトからドライバを落とすのが微妙にクソゲー
あまり他人の悪口書きたかないんですが、これだけは言わせてほしい。
Realtekのドライバを公式サイトからダウンロードするのに、一々reCAPTCHA入れて一時ダウンロードリンク生成してそこからダウンロードさせるのやめろよ、と。
当たり前ですが、 CLIしかないインスタンスでこれを突破するのは無理 なので、GUIを備えたクライアントを用意してそこからDLしてscpなりrsyncなりで飛ばすことになります (クソポイント1)
Realtek公式サイトからDLしたDKMSドライバを手直しするのが微妙にクソゲー
さて、DLできたドライバですが、そのまますぐインストール出来る訳ではありません。
何故って(少なくとも2026年05月04日にDLしたDKMSドライバ11.016.00では)、
- 解凍したドライバにdkms.confがそもそも無い(クソポイント2)
- 解凍した中身のパーミッションが狂っている(クソポイント3)
- 解凍した中身のMakefileの記述が『今動いているカーネルバージョンにしか対応していない』ので、手直ししないと OSカーネル更新時にビルドは通るけど再起動後にエラーを吐いてロードされない(クソポイント4)
KOTY(Kuso-code Of The Year)かよ。
という訳で手直しして、これをちゃんとOSカーネル更新の度にきちんとビルドされるようにしていきます。
手直し
./dkms.confの作成
まず最初に、前述したように dkms.confが不在 ですので、これを作っていきます。
PACKAGE_NAME="r8127"
PACKAGE_VERSION="11.016.00"
# CLEAN="make -C /lib/modules/$kernelver/build M=/usr/src/r8127-11.016.00/src clean"
CLEAN="make -C /lib/modules/$kernelver/build M=$dkms_tree/$PACKAGE_NAME/$PACKAGE_VERSION/build/src clean"
# MAKE[0]="make -j1 -C /lib/modules/$kernelver/build M=/usr/src/r8127-11.016.00/src modules"
MAKE[0]="make -j1 -C /lib/modules/$kernelver/build M=$dkms_tree/$PACKAGE_NAME/$PACKAGE_VERSION/build/src KVER=$kernelver modules"
BUILT_MODULE_NAME[0]="r8127"
BUILT_MODULE_LOCATION[0]="src/"
DEST_MODULE_LOCATION[0]="/kernel/driver/net/ethernet/realtek"
AUTOINSTALL="yes"
BUILD_EXCLUSIVE_KERNEL_MAX="6.15"
大体こんな感じ。
./Makefile
この行を……
KFLAG := 2$(shell uname -r | sed -ne 's/^2\.[4]\..*/4/p')x
こうじゃ!
KVER ?= $(shell uname -r)
KFLAG := 2$(shell echo $(KVER) | sed -ne 's/^2\.[4]\..*/4/p')x
./src/Makefile
132行目のelseより下の行に、以下の通り挿入します。
# 追加
KVER ?= $(shell uname -r)
KFLAG := 2$(shell echo $(KVER) | sed -ne 's/^2\.[4]..*/4/p')x
# 追加ここまで
# 従前
# BASEDIR := /lib/modules/$(shell uname -r)
# KERNELDIR ?= $(BASEDIR)/build
# 従前ここまで
# 修正案
BASEDIR := /lib/modules/$(KVER)
KERNELDIR ?= $(BASEDIR)/build
# 修正案ここまで
./src/Makefile_linux24x
正直RTL8127をLinux2.4のカーネルで動かそうという狂気を持った人は居ないはずなので割愛します(居ないよね?)
パーミッションの変更
そのままだとパーミッションが狂っている(少なくとも手元環境では盛大に狂った)ので、これを直します。
root@TestSV:~# ls -l /usr/src/
drwxr-xr-x 3 root root 7 11月 6 11:02 r8127-11.016.00
root@TestSV:~# ls -l /usr/src/r8127-11.016.00/
-rw-r--r-- 1 root root 1890 11月 6 10:54 Makefile
-rw-r--r-- 1 root root 4249 1月 28 2026 README
-rwxr-xr-x 1 root root 2469 1月 28 2026 autorun.sh
-rw-r--r-- 1 root root 398 11月 6 10:26 dkms.conf
drwxr-xr-x 2 root root 46 11月 10 05:15 src
root@TestSV:~# ls -l /usr/src/r8127-11.016.00/src/
-rw-r--r-- 1 root root 6148 11月 6 11:01 Makefile
-rw-r--r-- 1 root root 2430 11月 6 11:05 Makefile_linux24x
-rw-r--r-- 1 root root 0 11月 10 05:15 Module.symvers
-rw-r--r-- 1 root root 37 11月 10 05:15 modules.order
-rw-r--r-- 1 root root 98184 1月 28 2026 r8127.h
-rw-r--r-- 1 root root 4938576 11月 10 05:15 r8127.ko
-rw-r--r-- 1 root root 205 5月 19 16:52 r8127.mod
-rw-r--r-- 1 root root 6875 11月 6 09:58 r8127.mod.c
-rw-r--r-- 1 root root 157904 11月 10 05:15 r8127.mod.o
-rw-r--r-- 1 root root 4739416 11月 10 05:15 r8127.o
-rw-r--r-- 1 root root 15750 1月 28 2026 r8127_dash.c
-rw-r--r-- 1 root root 6451 1月 28 2026 r8127_dash.h
-rw-r--r-- 1 root root 515728 11月 10 05:15 r8127_dash.o
-rw-r--r-- 1 root root 14593 1月 28 2026 r8127_fiber.c
-rw-r--r-- 1 root root 2335 1月 28 2026 r8127_fiber.h
-rw-r--r-- 1 root root 433640 11月 10 05:15 r8127_fiber.o
-rw-r--r-- 1 root root 8750 1月 28 2026 r8127_firmware.c
-rw-r--r-- 1 root root 2470 1月 28 2026 r8127_firmware.h
-rw-r--r-- 1 root root 770924 1月 28 2026 r8127_n.c
-rw-r--r-- 1 root root 2800688 11月 10 05:15 r8127_n.o
-rw-r--r-- 1 root root 30963 1月 28 2026 r8127_ptp.c
-rw-r--r-- 1 root root 6257 1月 28 2026 r8127_ptp.h
-rw-r--r-- 1 root root 3644 1月 28 2026 r8127_realwow.h
-rw-r--r-- 1 root root 18848 1月 28 2026 r8127_rss.c
-rw-r--r-- 1 root root 3154 1月 28 2026 r8127_rss.h
-rw-r--r-- 1 root root 7956 1月 28 2026 rtl_eeprom.c
-rw-r--r-- 1 root root 2410 1月 28 2026 rtl_eeprom.h
-rw-r--r-- 1 root root 442104 11月 10 05:15 rtl_eeprom.o
-rw-r--r-- 1 root root 11377 1月 28 2026 rtltool.c
-rw-r--r-- 1 root root 2734 1月 28 2026 rtltool.h
-rw-r--r-- 1 root root 438312 11月 10 05:15 rtltool.o
ざっとこんな感じです。
インストール
あとは普通のdkmsドライバとしてインストールするだけです(少なくともこれで私の環境では全台通っている)。
後書き
RTL8127をどう使っているか
- PCIe Gen4 x1またはPCIe Gen3 x4(リンク自体はx2っぽい)なのをPCIe Gen3 x1で主に使ってます
-
X520の方がドライバ安定なんですが、如何せん発熱で死ぬ
RTL8127は低発熱
- ストレージ側でキャッシュ使い切ったら180〜400MB/sとかなので特に不便はしてない
RTL8127のここがダメ
- DKMS版Linuxドライバの出来が……
- Geminiくんと壁打ちして漸く、カーネルバージョンアップの度に手動ビルドしないと通らない謎現象を終わらせることができた
-
Debian14ではLinux7.2ベースになるという話があるらしいので、そうなるとインボックスドライバで動くことになるからDKMSドライバは御役御免の気がする。どうなるんだろう?????
まあその頃には25GbEに転向してる気もするけど