VirCloud's Blog

温馨提示：
本文所述内容具有依赖性，可能因软硬条件不同而与预期有所差异，故请以实际为准，仅供参考。

产品信息

最近新购入的一个号称免驱的 USB 3.0 转千兆网卡，在 Windows 下设备信息为：

使用芯片：ASIX AX88179
设备描述：ASIX AX88179 USB 3.0 to Gigabit Ethernet Adapter

在 Linux 下运行 lsusb 显示为：

  |__2-2         0b95:1790:0200 00  3.20 5000MBit/s 184mA 2IFs (ASIX AX88179A 00854698)

在群晖 DSM 信息中心中显示：

USB 设备         AX88179 Gigabit Ethernet - ASIX Electronics Corp. VID:0b95 PID:1790 REV:2.00

在 Windows 下使用时，确实是即插即用，但是插到群晖 NAS 上使用时发现无法识别为网卡，搜索了一番，发现是在群晖 NAS 在升级到 DSM 7 后默认删除了 USB 设备支持，需要额外安装驱动方可使用。

安装驱动

一般来说，自行编译源码来安装设备驱动是正确的选择，怎奈群晖 NAS 系统阉割比较厉害，很多必要的命令如 make 、gcc 等都无法使用，所以直接网上找现成的资源更快。

搜索了大半天，搜到的都是只支持到 DSM 6，经过一番折腾，终于找到了可以使用的驱动，在继续下文前，默认您会使用 Shell 命令，并已正确通过 SSH 连接到 NAS，大致步骤如下：

1、下载驱动：GitHub 地址，并解压；
2、将解压出来的驱动文件 mii.ko、usbnet.ko、ax88179_178a.ko 上传到 NAS 指定位置；
3、加载驱动文件；
4、DSM 任务计划中添加开机自动加载命令。

安装命令参考

Connection established.
To escape to local shell, press 'Ctrl+Alt+]'.


Synology strongly advises you not to run commands as the root user, who has
the highest privileges on the system. Doing so may cause major damages
to the system. Please note that if you choose to proceed, all consequences are
at your own risk.

admin@NAS:~$ sudo -i                                                    #使用 root 身份
root@NAS:~# lsusb                                                       #查看 USB 设备
|__usb1          1d6b:0002:0404 09  2.00  480MBit/s 0mA 1IF  (Linux 4.4.180+ xhci-hcd xHCI Host Controller 0000:00:15.0) hub
  |__1-1         0bda:1a2b:0200 00  2.00  480MBit/s 500mA 1IF  (Realtek DISK ffffffffffffffacffffffe5ffffffa1)
  |__1-2         0b95:1790:0200 00  2.10  480MBit/s 100mA 2IFs (ASIX AX88179A 00854698)
  |__1-4         f400:f400:0100 00  2.00  480MBit/s 200mA 1IF  (Synology DiskStation 7F0089FB38CA6003)
|__usb2          1d6b:0003:0404 09  3.00 5000MBit/s 0mA 1IF  (Linux 4.4.180+ xhci-hcd xHCI Host Controller 0000:00:15.0) hub
root@NAS:~# wget -O ax88179_178a-4.4.180plus.tgz https://github.com/pocopico/rp-ext/raw/main/ax88179_178a/releases/ax88179_178a-4.4.180plus.tgz                                                         #下载驱动包
--2022-03-24 15:19:49--  https://github.com/pocopico/rp-ext/blob/main/ax88179_178a/releases/ax88179_178a-4.4.180plus.tgz
Resolving github.com... 20.205.243.166
Connecting to github.com|20.205.243.166|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: unspecified [text/html]
Saving to: 'ax88179_178a-4.4.180plus.tgz'

ax88179_178a-4.4.180plus.tgz                  [ <=>                                                                               ] 125.67K   646KB/s    in 0.2s    

2022-03-24 15:19:51 (646 KB/s) - 'ax88179_178a-4.4.180plus.tgz' saved [128691]

root@NAS:~# tar zxf ax88179_178a-4.4.180plus.tgz                       #解压驱动包
root@NAS:~# ls                                                         #查看解压出来的文件
ax88179_178a-4.4.180plus.tgz  ax88179_178a.ko  mii.ko  usbcore.ko  usbnet.ko
root@NAS:~# insmod ax88179_178a.ko                                     #动态加载驱动
insmod: ERROR: could not insert module ax88179_178a.ko: Unknown symbol in module    #发现报错
root@NAS:~# dmesg |tail                                                             #查看报错信息
[ 5890.749244] ax88179_178a: Unknown symbol mii_nway_restart (err 0)
[ 5890.756081] ax88179_178a: Unknown symbol usbnet_nway_reset (err 0)
[ 5890.763013] ax88179_178a: Unknown symbol usbnet_update_max_qlen (err 0)
[ 5890.770441] ax88179_178a: Unknown symbol usbnet_stop (err 0)
[ 5890.776802] ax88179_178a: Unknown symbol generic_mii_ioctl (err 0)
[ 5890.783728] ax88179_178a: Unknown symbol usbnet_disconnect (err 0)
[ 5890.790655] ax88179_178a: Unknown symbol usbnet_link_change (err 0)
[ 5890.797676] ax88179_178a: Unknown symbol usbnet_probe (err 0)
[ 5890.804120] ax88179_178a: Unknown symbol usbnet_resume (err 0)
[ 5890.810660] ax88179_178a: Unknown symbol mii_ethtool_gset (err 0)
root@NAS:~# modinfo /lib/modules/ax88179_178a.ko |grep depend   #查看驱动包依赖项
-ash: modinfo: command not found
root@NAS:~# ln -s /bin/kmod /sbin/modinfo                       #命令不存在，链接一下命令先
root@NAS:~# modinfo /lib/modules/ax88179_178a.ko |grep depend   #再次查看驱动包依赖项
depends:        usbnet,usbcore,mii
root@NAS:~# insmod mii.ko                                       #依赖项从右边的开始装
root@NAS:~# insmod usbcore.ko 
insmod: ERROR: could not insert module usbcore.ko: Invalid module format #报错了，暂时不用管
root@NAS:~# insmod usbnet.ko 
root@NAS:~# insmod ax88179_178a.ko                              #驱动安装成功且无报错，所以我们需要装的只有 mii.ko、usbnet.ko 和 ax88179_178a.ko
root@NAS:~# ifconfig                                            #查看网卡信息
eth0      Link encap:Ethernet  HWaddr 00:00:32:9B:BB:FF   
          inet addr:10.2.0.111  Bcast:10.2.0.255  Mask:255.255.255.0
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:179534 errors:0 dropped:0 overruns:0 frame:0
          TX packets:37719 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:103513432 (98.7 MiB)  TX bytes:8515560 (8.1 MiB)

lo        Link encap:Local Loopback
          inet addr:127.0.0.1  Mask:255.0.0.0
          inet6 addr: ::1/128 Scope:Host
          UP LOOPBACK RUNNING  MTU:65536  Metric:1
          RX packets:14001 errors:0 dropped:0 overruns:0 frame:0
          TX packets:14001 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1 
          RX bytes:1665418 (1.5 MiB)  TX bytes:1665418 (1.5 MiB)

root@NAS:~# ifconfig eth1 up                                    #启用网卡
root@NAS:~# ifconfig                                            #查看网卡信息
eth0      Link encap:Ethernet  HWaddr 00:00:32:9B:BB:FF    
          inet addr:10.2.0.111  Bcast:10.2.0.255  Mask:255.255.255.0
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:179534 errors:0 dropped:0 overruns:0 frame:0
          TX packets:37719 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:103513432 (98.7 MiB)  TX bytes:8515560 (8.1 MiB)

eth1      Link encap:Ethernet  HWaddr 62:61:D3:2E:2D:FE  
          UP BROADCAST MULTICAST  MTU:1500  Metric:1
          RX packets:0 errors:0 dropped:0 overruns:0 frame:0
          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:0 (0.0 B)  TX bytes:0 (0.0 B)

lo        Link encap:Local Loopback
          inet addr:127.0.0.1  Mask:255.0.0.0
          inet6 addr: ::1/128 Scope:Host
          UP LOOPBACK RUNNING  MTU:65536  Metric:1
          RX packets:14001 errors:0 dropped:0 overruns:0 frame:0
          TX packets:14001 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1 
          RX bytes:1665418 (1.5 MiB)  TX bytes:1665418 (1.5 MiB)
root@NAS:~# lsusb                                                       #再次查看 USB 设备
|__usb1          1d6b:0002:0404 09  2.00  480MBit/s 0mA 1IF  (Linux 4.4.180+ xhci-hcd xHCI Host Controller 0000:00:15.0) hub
  |__1-1         0bda:1a2b:0200 00  2.00  480MBit/s 500mA 1IF  (Realtek DISK ffffffffffffffacffffffe5ffffffa1)
  |__1-4         f400:f400:0100 00  2.00  480MBit/s 200mA 1IF  (Synology DiskStation 7F0089FB38CA6003)
|__usb2          1d6b:0003:0404 09  3.00 5000MBit/s 0mA 1IF  (Linux 4.4.180+ xhci-hcd xHCI Host Controller 0000:00:15.0) hub
  |__2-2         0b95:1790:0200 00  3.20 5000MBit/s 184mA 2IFs (ASIX AX88179A 00854698)

至此网卡驱动安装成功，且已经被群晖 NAS 识别到，接下来去 DSM 管理面板对网卡进行 IP 配置即可。

开机自动启用

由于我们是装的驱动是第三方的，群晖 NAS 重启后并不会自动加载，因此需要在 DSM 的任务计划中设置一个开机自动挂载的任务。

如下图，任务计划中添加一个开机任务：

运行命令

其中，用户定义的脚本如下：

insmod /root/mii.ko 
insmod /root/usbnet.ko 
insmod /root/ax88179_178a.ko 
ifconfig eth1 up

任务计划.jpg

参考文章：

1、《历尽磨难，群晖Dsm7.0编译E10M20-t1(aqc107)网卡驱动，终获成功！》
2、《GitHub：pocopico/rp-ext》
3、《黑群晖6.17 安装ax88179_178a.ko驱动（USB千兆网卡）》

精选评论

欧文斯博主 回复
2022 年 03 月 24 日

界面上看可以用了，实际上后台日志报错不可用
1. 欧文斯博主 回复
  2022 年 03 月 24 日
  
  日志查看命令：dmesg | tail
  1. 欧文斯博主 回复
    2022 年 03 月 24 日
    
    经查询，USB 网卡接在 2.0 接口正常，3.0 无法工作
2. 欧文斯博主 回复
  2022 年 03 月 25 日
  
  驱动全新编译方法：《搭建群晖 Synology NAS 开发环境，自编译网卡等驱动》
疆飞回复
2022 年 11 月 06 日 Windows 10Chrome 106.0.0.0来自火星的大神

分享了又好像没分享，博主太小家子气，虽然说解除网站禁止复制很简单，但是这做法真的让人觉得有点那个啥！！！呵呵呵。什么时代了，还有博主这么干！！！
1. 欧文斯博主 回复
  2022 年 11 月 06 日
  
  正常使用，完全不影响，只有想要长文复制时才会出现提示
  1. 疆飞回复
    2022 年 11 月 06 日 Windows 10Chrome 106.0.0.0来自火星的大神
    
    网卡插上以后，交换机和USB网卡的灯都是亮的。进入群辉也可以看到USB设备已经驱动起来了，也能看到 “局域网2” 但是它的状态是尚未联网。
    
    欧文斯博主 回复
    2022 年 11 月 06 日
    
    看一下启动日志里有没有报错 dmesg |tail
2. 疆飞回复
  2022 年 11 月 06 日 Windows 10Chrome 106.0.0.0来自火星的大神
  
  按照你的教安装了驱动，但是这张网卡无法联网！！！
  1. 欧文斯博主 回复
    2022 年 11 月 06 日
    
    我咨询过芯片工程师，不建议再用 ax88179 的驱动，使用内核自带的驱动就可以了，方法参见《成功在群晖 NAS 用上 USB 千兆网卡，完整使用教程》
Pingback
2023 年 06 月 20 日

群晖 DSM 7.0 加装外接免驱 USB 千兆网卡（ASIX AX88179） - VirCloudR17;s Blog - Learning&Sharing | 神奇小玉玉
LZIZA 回复
2023 年 08 月 18 日 Windows 10Chrome 115.0.0.0来自香港的大神

我从不会任何nas命令，到买了这个usb网卡，学习了博主这篇，感觉真的是活到老学到老，经过千山万水，总算是可以把网线接到usb网口正常开机后台访问了，但是点到网络一看，居然显示的100M的，我心那个凉啊，有没有什么方法让我的usb千兆网卡识别成千兆呀。感谢啦
1. 欧文斯博主 回复
  2023 年 08 月 20 日
  
  试试内核自带的驱动，方法参见《成功在群晖 NAS 用上 USB 千兆网卡，完整使用教程》

群晖 DSM 7.0 加装外接免驱 USB 千兆网卡（ASIX AX88179）

产品信息

安装驱动

安装命令参考

开机自动启用

跨屏阅读

微信扫一扫

精选评论

相关文章

主机推荐

添加好友/加入微信群

微信扫一扫