Credential Related

Error

error getting credentials - err: exec: “docker-credential-desktop.exe”: executable file not found in $PATH, out: ``

解决方法根据情况可能是以下的两种：参考资料1 | 参考资料2 WSL2 | 参考资料3

WSL2 相关的情况下可能需要执行以下的挂载：

# 执行挂载
sudo ln -s /mnt/c/Program\ Files/Docker/Docker/resources/bin/docker-credential-desktop.exe /usr/bin/docker-credential-desktop.exe

也可能是需要修改 ~/.docker/config.json 或者 /root/.docker 中的 credsStore 改为 credStore

Docker Desktop 更新后 Container 消失

Error

Docker-Desktop-Data 没有正确启动，导致 Docker Desktop 在版本更新/电脑重启后，所有的 Container 消失了

前一阵，更新 Docker Desktop 版本/重启电脑后所有的 container 消失了，重启 Docker, WSL2, Windows，均无法将 Container 找回，怀疑是 Docker 更新后没有正确识别迁移的 Docker-Desktop-Data 和 Docker-Desktop 地址导致找不回数据。

此时，首先不要删除 docker-desktop 版本去做一些版本回退或者其他删除 Docker-Desktop 的行为，这样做会连带将整个 docker-desktop-data 的 vhdx 挂载盘也删除，这样会导致部分未 Mount 到 WSL2 的数据无法找回，彻底无法恢复原本 Container 的部分信息。

因此，无论在回退或者重装 docker-desktop 之前，建议做以下的验证：

1. 使用 wsl -l -v 查看 Dokcer-Desktop-Data 是否正常启动(状态为 RUNNING)
2. 查找当前 Docker-Desktop 和 Docker-Desktop-Data 当前的挂载位置，是否是安装时迁移出来的位置，可以参考 管理WSL2磁盘空间 的最后一小节找到 vhdx 的位置；
3. 如果还是原本的位置，参考自己部署服务的 compose file 查看对应位置的文件是否还存在，如果不存在了，可能是被覆盖了，那可能也是没救了；
4. 如果位置和迁移出来的位置不一致，说明是 Docker-Desktop 对应的数据内容位置不对的问题，可以直接按照 WSL2 的步骤重新导入 Docker-Desktop-Data 尝试能不能找回数据；

如果数据已经无法恢复，也就只能重新部署服务，需要注意的是，如果是 docker-desktop-data 没有启动的问题，且发现对应的 volume 信息已经没有了，这就说明之前的 container 和 volume 等信息可能是存在临时目录已经找不回了，接下来就是如何正确避免再次发生这种情况。

查阅后发现，这是由于将 Docker-Desktop-Data 的挂载到了别的目录，但是 Docker-Desktop 无法正确识别迁移后的地址，他还会在原本的地址找 Vhdx 文件，如果没找到就会导致 Docker-Desktop-Data 无法和 Docker-Desktop 关联起来，相关的服务也就不会启动。

这里通过 CMD 来建立软连接（mklink {target_path} {file_real_path}）：

# 建立软连接（需要再cmd中执行，powershell中可能识别不了mklink命令）
# 否则可能会导致 docker-desktop-data 无法正确启动，导致重启后掉盘
mklink "C:\Users\{user-name}\AppData\Local\Docker\wsl\data\ext4.vhdx" "D:\docker\docker-desktop-data\ext4.vhdx"

重启 docker-desktop 后再重新部署服务即可，可以简单的部署个别文件后重启检查，部署的时候需要注意

• 如果部署所需的文件&数据库都已经 mount 到对应的 WSL2 上了，整个重新部署的流程会相对简单一些，而且也不会有信息丢失
• 部分无法 Mount 的服务建议查看官方文档是否有备份方法，例如 Immich 的用户数据库，需要手动使用脚本进行备份和后续导入，否则虽然照片不会丢失，但是无法和原始账号关联，只能使用曲线救国的方式去重新将旧照片导入新账号。

因此对于存储重要用户数据的 Docker 服务，建议是在将数据都 mount 出来的同时，做好对应服务器的容灾备份，我这里是使用了 kopia 将服务器里重要的数据都做了额外备份，但是还是对 Immich 的数据备份缺失了用户设置的部分。

Summary

在部署一个服务的时候，要调查好做服务迁移的时候需要备份和导出的内容, 尽量将数据 mount 到主机上，同时结合 Crontab 和 kopia 等工具去做一个定时的容灾备份，确保自己的重要数据万无一失。

Vmmem 内存和 CPU 占用过高

大概率是由于 WSL2 没有限制 docker-desktop 的内存和 CPU 用量导致的，这种时候重启一下 docker-desktop 使用率应该就会回到正常值，一劳永逸的话参考一下下面的 [CPU 设置]( #Cpu & Memory Usage Too High) 章节。

Basic Information & Setting 基础信息和设置

Where The Volumes of Container Storage

Locating data volumes in Docker Desktop (Windows) : 除了指定了目录的 volume，其他 docker-desktop(WSL2) 的 volume 将会存放在 \\wsl.localhost\docker-desktop-data\data\docker\volumes 中

Cpu & Memory Usage Too High

修改 windows 上 WSL2 的配置文件，限制 docker 对应的 WSL 服务的内存和内核上限，官方的设置文档如下：wslconfig ，其他参考资料 CSDN

配置文件的地址为：c:\user\{your name}\.wslconfig ，如果没有该文件就手动创建一个，可以仅仅简单的配置如下项目即可，具体的数值参考自己电脑的配置，更多配置项可以参考官方文档：

[wsl2]
# 核心数配置
processors=8
memory=8GB

保存后用如下命令关闭 WSL 并重启docker即可

wsl --shutdown

在 Windows 和 WSL2 中安装 Cuda 和 Cudnn ，是配置 GPU 开发环境中重要的一步，其支撑了 AI 模型进行 Training 和 Interface 。本篇介绍安装 CUDA 和 Cudnn 的步骤和一些踩过的坑。

参考资料如下：版本查看 | Win 安装 Cuda 和cuDNN | WSL 2 安装 CUDA 和cuDNN

Win 11 安装 CUDA 和 cuDNN

CUDA

首先在 Nvidia 的控制面板：帮助-系统信息的如下位置，查看 GPU 最大支持的 CUDA 版本：

也可以使用 Nvidia-smi 命令在 Powershell 或者 CMD 中查看:

确定了版本之后到 Nvidia CUDA下载页面 下载指定版本的 CUDA 进行安装（根据安装指引进行）即可，安装位置等默认即可，其中有一些安装选项即是 Nvidia GeForce Experience 安装的内容。

安装完成后在 CMD 或者 PowerShell 确认是否安装完成（需要重启终端）：

nvcc -V

显示如上信息可看到指定的版本已经安装成功，然后我们可以在 CMD 中执行如下命令来获取安装地址/设置环境变量：

set cuda

完成这些后我们就可以开始安装 CuDNN 了，CuDNN 的安装需要我们记住 Cuda 的安装地址。

cuDNN

在 Nvidia 官网注册账号，并在 cuDNN 下载界面 下载对应版本的 Package 后，讲 Package 中各个目录下的内容放到 CUDA 文件夹的对应目录下即可。

即 mv cuDNN/lib/* CUDA/lib/* …；拷贝完成后可以执行 CUDA 中自带的校验工具查看安装情况：

• /cuda/extras/demo_suite/deviceQuery.exe
• /cuda/extras/demo_suite/bandwidthTest.exe

可以看到验证详细结果和是否通过。

WSL 2 配置 CUDA 和 cuDNN

建议可以先看看： NVIDIA GPU Accelerated Computing on WSL 2

新版的 WSL 2 对于 GPU 的支持已经相当的友善，能够直接调用 Windows 的 GPU，但是在使用过程前还是需要对环境进行一定的配置。具体分为以下的两步：

1. 安装 cuda-toolkit：注意不能重复安装 CUDA 驱动，避免和 Windows 系统的 CUDA 驱动产生冲突
2. 安装 cuDNN
3. （非必须）设置环境变量

以下以 Ubuntu WSL 2 为例，介绍以下具体的安装过程。

CUDA-toolkit on WSL 2

通过 Nvidia 的官方下载页面 选择 WSL-Ubuntu 即可找到对应的安装工具，我们这里选择 runfile 的方式进行，按照官方给出的安装指令进行，即：

wget https://developer.download.nvidia.com/compute/cuda/12.1.1/local_installers/cuda_12.1.1_530.30.02_linux.run

sudo sh cuda_12.1.1_530.30.02_linux.run

下载对应的 run 包后执行安装即可。

cuDNN on WSL 2

在 Ubuntu 上安装 cuDNN 实际上除了网上资料很多的下载包进行安装，直接用以下的方式进行安装即可。

sudo apt install nvidia-cudnn

安装后执行 nvcc –version 验证版本。

Env

这一块的设置好像目前已经是不需要的，首先可以尝试不配置这一块内容。以下我会给出我这边的配置

环境配置这块好像并不需要执行，如果还是报错的话，可以按照以下的方式来配置 zshrc 或者 bashrc。

export CPATH=/usr/local/cuda/include:$CPATH
export LD_LIBRARY_PATH=/usr/local/cuda/lib64/:$LD_LIBRARY_PATH
export PATH=/usr/local/cuda/bin:$PATH
export CUDA_ROOT=/usr/local/cuda

or

export LD_LIBRARY_PATH=/usr/local/cuda-12.1/lib64/{LD_LIBRARY_PATH:+:{LD_LIBRARY_PATH}}

这里顺便给出一个路径 /usr/lib/wsl/lib 中会有相关的 so 文件的路径，应该是和主机互通的地方。

报错分析

Could not load library libcudnn_cnn_infer.so.8. Error: libcuda.so: cannot open shared object file: N

没有安装或者配置 cudnn

Install Docker on Windows

该部分主要介绍以下几内容：安装，存储盘迁移，连接 WSL2 发行版，完成了这几步之后就可以畅游 Docker 世界了。

前置：先安装好一个 WSL2 的发行版，win11 自带 WSL2

首先，官网 Docker: 下载 Docker Desktop for windows，安装基于 WSL2 的 docker，安装完成后 Docker 的发行版和存储目录会默认存放在，该地址可以用来确认后续的迁移状态。

• Docker-Desktop/data：%LOCALAPPDATA%/Docker/wsl
• WSL2：%LOCALAPPDATA%/packages/c......./local_state

安装完后首先打开 docker 确认没有其他异常问题报警，然后就可以对存储空间和 Desktop 进行迁移（option），迁移的方式可以参考上文中对 WSL2 的迁移。下面给出脚本便于使用：

wsl --shutdown

# 系统导出
wsl --export docker-desktop-data "D:\docker\docker-desktop-data.tar"
wsl --export docker-desktop "D:\docker\docker-desktop.tar"

# 删除原系统
wsl --unregister docker-desktop-data
wsl --unregister docker-desktop

# 挂载新目录
wsl --import docker-desktop D:\docker\docker-desktop D:\docker\docker-desktop.tar
wsl --import docker-desktop-data D:\docker\docker-desktop-data D:\docker\docker-desktop-data.tar

# 建立软连接（需要再cmd中执行，powershell中可能识别不了mklink命令）
# 否则可能会导致 docker-desktop-data 无法正确启动，导致重启后掉盘
mklink "C:\Users\{user-name}\AppData\Local\Docker\wsl\data\ext4.vhdx" "D:\docker\docker-desktop-data\ext4.vhdx"

迁移完成后重启 docker 即可，至此，安装就算完成了。

Basic Setting

为了发挥完整的性能，以及更容易执行 volume 参数进行 data 的挂载，这边强烈建议在 wsl2 中使用 docker！为此，在 docker-desktop 中需要设置如下的几个地方：

例如 alist 镜像，在 wsl2 中设置好了 volume 参数，把 data 准确的挂载出来后，数据就不会再 docker 重启的时候丢失了。

设置完成后，在 WSL2 中就可以识别和执行 Docker 命令了，后续对 docker、docker-compose 的操作都在 WSL2 中完成即可，接下来就可以在 docker 的应用市场中愉快的淘金了。

Docker Apps( personal recommand )

后续会对其中的一些来做简单的部署和讲解，其实很多都挺适合在 NAS 上部署的，结合内网穿透技术能有一个更好的体验，后面也可以简单介绍以下内网穿透。

1. Alist 个人云管理中心，统一管理，访问，在线观看等，强力推荐
2. Immich 局域网图片备份和管理中心，有移动端 APP，自动备份，权限隔离，
3. Kavita 图书、PDF 管理中心（还在找更好的 pdf 中心）
4. wikijs 个人 wikipage
5. foamzou/melody：音乐资源搜索和自动上传网易云云盘
6. memos：个人备忘录中心

想要一个能够同时管理书籍和论文的 PDF 管理中心，最好能够集成一个比较好的 PDF 阅读和标记工具（比如直接用 Edge 把），不知道有没有类似的。

• win11 中 wsl2 已经支持相应主机的 cuda，便利了机器学习的开发；
• 子系统中通过/mnt 挂载了 windows 的磁盘，可以通过子系统访问和管理 windows 环境；
• windows 资源管理器可访问和管理子系统中的文件
• 支持 windows 打开子系统中的 GUI 应用

无论是将 windows 和 linux 分别作为日常和开发的环境来隔离，还是两个协同去做开发和日常，都是一个比较不错的选择，下面就介绍一下如何安装和使用 WSL2。

• 开始之前可以参考 windows terminal 安装一下这个官方的终端模拟器，在 windows 上的表现是比较优秀的
• 如果是考虑在 windows 环境开发的话，也可以参考这个[windows]，里面有我个人推荐的一些应用。

启用并安装 WSL2

安装和启用 WSL2 需要在 windows 的服务中勾选 Hyper-V 和 Windows Subsystem Linux 支持两个选项，具体操作如下：

1. Win + S 搜索 “功能”，打开启用或关闭 windows 功能
2. 启用对应功能，功能安装完毕后即可
   
   
3. 安装 linux 发行版可以在 windows store 安装，也可以通过如下的命令进行安装：

# 列出对应的发行版
wsl -l -o
# 选择相应的发行版进行安装
wsl --install -d <Distribution Name>
# 如果当前的WSL是1版本，更新到2
wsl -l -v
wsl --set-default-version 2

安装完发行版之后，WindowsTerminal 中应该会自动出现其配置文件，如果没有出现也不要紧，可以先迁移其存储位置后再添加配置文件。

Mount And Move

WSL 的默认存储路径：%LOCALAPPDATA%/packages/c......./local_state 搜索 Ubuntu 文件夹

而通常 windows 都会有分区，如果是 C 盘较小的（建议是可以不用分区），可以修改 WSL 的默认存储路径，将磁盘挂载在别的地方，操作如下：

首先关闭对应的 wsl 服务，并查看关闭的状态：

wsl --shutdown
wsl -l -v # 查看状态

确认已经关闭后我们可以将该子系统文件导出，并将原有的系统注销删除

# 导出wsl2 system； docker-desktop & docker-desktop-data
# 导出系统 wsl --export <DistroName> <PathToTarArchive>
wsl --export Ubuntu-20.04 E:\WSLWorkspace\ubuntu.tar

# 删除（注销）系统
wsl --unregister Ubuntu-20.04

最后在我们希望的地方重新注册该系统：

# 导入系统到指定的新位置(使用新路径导入新系统)
wsl --import Ubuntu-20.04 E:\WSLWorkspace E:\WSLWorkspace\ubuntu.tar

通常来说，wsl 会自动为系统生成配置文件，这里在 terminal 中可能会出现两个 ubuntu 的 unid，那么我们就把第一个配置文件删掉，然后修改新的配置文件为（主要是在后面添加-u user_name）在指定启动的用户：

<...wsl.exe> -d ubuntu -u <user_name>

or 修改注册表，可以参考以下的方法： wsl2系统迁移到非系统盘

or 尝试，但是注意这种方式就不急着注销系统，因为他可能会重新安装在 C 盘，所以最后在注销。

ubuntu2204 config --default-user <user_name>

删除多余的所有 tar，over

Docker（based on wsl2）

基于 WSL2 安装的 Docker 也能用这种方式迁移相应的存储地点。就仅给出大概的操作流程，不在赘述。

# export
wsl --export docker-desktop-data "D:\docker\docker-desktop-data.tar"
wsl --export docker-desktop "D:\docker\docker-desktop.tar"

# unresiester
# import 
# restart

SSH

wsl2启用SSH ，ssh功能应该默认是启用的，如果ssh没有启用的话

vim /etc/ssh/sshd_config

修改如下的几个配置

Port = 22 去掉这行的 #，代表启用端口号 22 ListenAddress 0.0.0.0 去掉这行的#，代表监听所有地址 PasswordAuthentication yes，将这行的no改成yes，代表支持账号密码形式的登录

重启服务

sudo service ssh restart

此时还不能支持root用户密码登录,默认情况下，root用户只支持用RSA登录，但是可以修改配置的,切换到root用户打开SSH的配置文件

找到行PermitRootLogin prohibit-password保留这行的#，这意味着：允许root登录，但是禁止root用密码登录，所以这行要注释掉。 需要添加一行:

PermitRootLogin yes

剩下的其余配置按照Linux文档进行文件的配置

PROXY

Update

由于 WSL 2 中许多 CLI 工具都需要额外的进行代理设置，还有一些代码中也需要指定代理，令人不厌其烦，因此这里更新对于诸多 CLI 的额外设置。

参考资料（从前到后）：

• Ubuntu「一键」设置代理 | Sukka’s Blog (skk.moe)
• WSL2 的一些网络访问问题 | Artin’s Blog (cat.ms)
• TUN 模式 | Clash for Windows
• WSL 开发环境代理设置 - sulinehk’s blog
• WSL2 配置代理 (kiritoghy.cn)

推荐）通用方案：使用 Clash 的 TUN 模式，该方案会设置一个虚拟网卡，自动接管该方案设置完毕后无需配置 WSL 中任意 CLI 的代理。

首先基于 server 旁边的地球按钮安装需要的依赖，安装完后就可以打开 tun 模式。

备选）基础方案：使用脚本设置各个常用 CLI 的代理，需要设置代理的主要有以下这些：npm, yarn 等专用软件。

wget 和 curl 这种使用的是全局的代理，所以不需要额外的设置， 但是像 npm 之类的专有软件一般有命令或者对应的配置文件；

基于参考资料，个人基于需求进行修改，提供脚本如下：

除了上述文章提到的这些，还有一个很容易遇到的问题就是 pip 的安装问题，设置 pip 的代理的方式有以下几种：

• 使用 pip 的 --proxy 选项设置代理：pip install libname --proxy http://127.0.0.1:7890
• 直接编辑pip的配置文件pip.ini，在其中的[global]下面添上一行proxy = http://127.0.0.1:7890
• 使用 pip 的 config 命令来写配置文件：pip config set global.proxy http://127.0.0.1:7890

参考文献：pip：ProxyError(‘Cannot connect to proxy. - CodeAntenna

Basic

set the proxy for the WSL from windows, so we can update the packages ez.

1. 首先获取windows IP:

cat /etc/resolv.conf|grep nameserver|awk '{print $2}'
# 假设获取的windows ip 为170.20.0.1

2. 查看代理软件的端口设置，开启局域网 LAN 链接，开启防火墙

• 添加入站规则 -> 新建规则
• 类型：自定义
• 程序：所有程序
• 协议和端口：默认
• 作用域：
  • 本地为任何 ip
  • 远程为下列 IP，把 WSL2 获取到的 ip 添加进去（比如上面就是 172.20.0.0/20）（掩码一般是 20 位）
• 操作：允许链接
• 配置文件：三个全选
• 名称：自定义

3. Clash 开启 LAN 和端口,
4. WSL2 中设置代理

export https_proxy=172.20.0.1:8890
export http_proxy=172.20.0.1:8890

Reference： proxy配置参考

这里提供一下 WSL 的代理设置脚本

# show and set proxy for WSL
function GetHostIp(){
  ip=$(cat /etc/resolv.conf|grep nameserver|awk '{print $2}')
  echo "the host ip is: $ip, then we ping it to test fireware"
  ping $ip
}

function SetProxy(){
  ip=$(cat /etc/resolv.conf|grep nameserver|awk '{print $2}')
  export http_proxy=http://$ip:8890
  export https_proxy=https://$ip:8890
}

function unsetProxy(){
  unset http_proxy
  unset https_proxy
}

alias getip=GetHostIp
alias proxyon=SetProxy
alias proxyoff=unsetProxy

SETTING

WSL在Windows Terminal的启动目录设置

//wsl$/Ubuntu-20.04/home/aikenhong

Vmmem 内存占用问题

Windows 使用 Wsl2 & 基于 Wsl2 的 Docker 时会发现 Vmmem 占用了系统大量的内存（15g/32g），且同时 Docker Dashboard 和 Linux 中的 Top 命令都显示占用并不高。

Vmmem 进程是 Windows 系统为 WSL2 系统预留的虚拟进程，为 WSL2 向系统申请内存和 CPU 资源，即使在 WSL2 并不需要的时候也会保留大量的内存，其默认消耗总内存的50% (20175之前的版本则是80%) 或者 8G，选择其中较小的一个执行。

• 如果需要使用内存且无需 WSL2 时可以使用 wsl --shutdown 命令关闭 WSL2；

进入用户文件夹后，新建 or 打开 .wslconfig 文件

• powershell cd ~
• WIN+R %UserProfile%
• 资源管理器 %UserProfile%

在其中可以编辑 wsl2 的 memory 选项，手动其内存使用的上限：

# Settings apply across all Linux distros running on WSL 2 
[wsl2] 
memory=8GB 

重启 WSL 或者直接重启电脑即可。