Windows on Tuan's Blog

Windows 10/11 配置 OpenSSH Server：密钥登录与默认 shell

Tue, 16 Apr 2024 09:56:35 +0800

前言

Windows 10/11 自带了 OpenSSH Server（以“可选功能”的形式提供），可以让你像在 Linux 系统上一样远程使用 shell。本文介绍如何安装和配置 OpenSSH Server、如何使用密钥登录，以及如何把默认终端从 cmd 改为 PowerShell。

下文中“服务器”指要被远程登录的那台 Windows 电脑，“客户端”指你用来发起 ssh 连接的电脑。所有 PowerShell 命令都需要以管理员身份运行。

安装 OpenSSH Server

以管理员身份打开 PowerShell。

查看 OpenSSH 相关组件的安装状态：

1

Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*'

安装 OpenSSH Server：
1

Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
当然，你也可以通过图形界面安装：“设置” → “应用” → “可选功能” → “添加功能”（Win11 为“查看功能”），搜索并勾选“OpenSSH 服务器”即可。
启动 OpenSSH Server：
1

Start-Service sshd

设置 OpenSSH Server 开机自启：

1

Set-Service -Name sshd -StartupType 'Automatic'

检查 OpenSSH Server 是否已经启动：
1

Get-Service sshd

安装程序一般会自动创建名为 OpenSSH-Server-In-TCP 的防火墙入站规则（放行 TCP 22 端口），可以确认一下：

1

Get-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' | Select-Object Name, Enabled

如果提示找不到该规则，手动创建：

1

New-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' -DisplayName 'OpenSSH Server (sshd)' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22

配置密钥登录

1. 生成密钥对

在客户端上生成密钥对，如果已经有密钥对可以跳过这一步。常用的密钥类型有 rsa、ecdsa、ed25519（dsa 已被新版 OpenSSH 默认禁用，不要再用），这里使用 ed25519：

1

ssh-keygen -t ed25519

生成的公钥默认是 ~/.ssh/id_ed25519.pub（Windows 上即 C:\Users\<用户名>\.ssh\id_ed25519.pub）。

2. 把公钥放到服务器上

特别注意！！ 与 Linux 下的 OpenSSH Server 不同，Windows 版 OpenSSH 的 sshd_config 末尾默认有这样一段：

1
2


Match Group administrators
 AuthorizedKeysFile __PROGRAMDATA__/ssh/administrators_authorized_keys

也就是说，管理员组的用户不会读取自己目录下的 ~/.ssh/authorized_keys，而是统一读取 C:\ProgramData\ssh\administrators_authorized_keys。公钥放错地方，就会一直提示输入密码：

根据你的情况二选一：

做法 A：注释掉 Match 段（我的做法）

用管理员权限的编辑器（例如以管理员身份运行的 VS Code 或记事本）打开 C:\ProgramData\ssh\sshd_config，把上面两行注释掉：

1
2


# Match Group administrators
# AuthorizedKeysFile __PROGRAMDATA__/ssh/administrators_authorized_keys

然后把客户端公钥的内容追加到服务器上的 C:\Users\<用户名>\.ssh\authorized_keys 文件中（没有 .ssh 目录就新建一个）。这样管理员和普通用户的行为就和 Linux 一致了。

做法 B：保持默认，使用 administrators_authorized_keys

把公钥内容追加到 C:\ProgramData\ssh\administrators_authorized_keys，然后在管理员 PowerShell 中修正它的权限（只允许 Administrators 和 SYSTEM 访问，否则 sshd 会拒绝读取）：

1

icacls.exe "C:\ProgramData\ssh\administrators_authorized_keys" /inheritance:r /grant "Administrators:F" /grant "SYSTEM:F"

3. 编辑 sshd_config

继续编辑 C:\ProgramData\ssh\sshd_config（修改需要管理员权限），确认以下配置：

1
2
3
4


# 启用密钥登录
PubkeyAuthentication yes
# 禁止密码登录，确保安全性（建议先确认密钥能登录再改）
PasswordAuthentication no

注意：sshd_config 只把以 # 开头的行当作注释，不要把注释写在配置项的同一行后面。

修改完成后保存并退出。

4. 重启 sshd 服务

在 PowerShell（管理员）中重启 sshd 服务，让配置生效：

1

Restart-Service sshd

设置默认 shell 为 PowerShell

Windows OpenSSH 默认的 shell 是 cmd。在 PowerShell（管理员）中运行以下命令，把默认 shell 改为 Windows PowerShell：

1

New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell -Value "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe" -PropertyType String -Force

修改对之后的新连接生效。想改回 cmd，删除这个注册表值即可：

1

Remove-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell

连接

没啥说的了吧，你肯定会了。在客户端上：

1

ssh <用户名>@<服务器 IP 或主机名>

用户名是服务器上的本地账户名，不确定的话在服务器上运行 whoami 看一下（输出为 计算机名\用户名）。
连不上时加 -v 查看详细过程：ssh -v <用户名>@<服务器>；服务器端的日志可以在“事件查看器” → “应用程序和服务日志” → “OpenSSH” → “Operational”中查看。

一切正常的话，大概是这样：

引用

官方文档：OpenSSH for Windows 入门
官方文档：OpenSSH for Windows 中基于密钥的身份验证
官方文档：Configuring the default shell for OpenSSH in Windows

为 Windows Terminal 配置 zsh + Oh My Zsh！[非 WSL]

Sun, 24 Mar 2024 01:13:01 +0800

在 Windows 里做到类 Unix 系统的使用体验

先上效果图：

前言

最近又回到使用 Windows 环境开发。在 Windows 下获得类 Unix 系统的体验一直不是很好，尤其是在使用命令行时。Windows 自带的命令行工具 cmd 和 PowerShell 都不如 Unix 系统下的 bash 和 zsh 好用。所以，我决定在 Windows 下折腾一下 zsh，并且让 zsh 能在 Windows Terminal 中使用。

整体思路如下：Windows Terminal 只负责“窗口”，真正干活的是 Cygwin 提供的 zsh.exe，Oh My Zsh 再在 zsh 之上负责主题和插件。

环境要求

以下步骤是在 Windows 10 及以上系统中进行的（更推荐 Win11，截至 2024-03-26 已经是 Win11 23H2 22631.3296）。

为了节省时间，文章中类似下载安装等基础入门的步骤我是用 GitHub Copilot 生成的，并经过了我的审核，避免一眼 AI 犯的低级错误。

安装 Windows Terminal（必须）

软件源

Windows Terminal 有两种可信的下载安装渠道：

Microsoft Store 中下载安装；
从 GitHub 的 releases 页面下载最新的安装包。

任选其一即可，小白推荐使用 Microsoft Store 安装。Windows 11 已经自带 Windows Terminal，可以跳过这一步。

方法 1：Microsoft Store

打开 Microsoft Store，搜索“Windows Terminal”。
点击“获取”，然后安装。
安装完成后，打开“开始”菜单，找到并运行“Windows Terminal”。

方法 2：GitHub Releases

访问 GitHub 的 releases 页面。
下载最新的 .msixbundle 文件。
双击下载的文件，开始安装。
安装完成后，打开“开始”菜单，找到并运行“Windows Terminal”。

安装 Cygwin（极力推荐）

这里没有选择 Git for Windows 的原因是：装上了就真的只是装上了 = = 啥也不知道，包括背后的原理……

Cygwin 是一个在 Windows 上运行的类 Unix 环境。它提供了一套类 Unix 系统下的工具和库，可以让你在 Windows 上获得类 Unix 系统的体验。

个人理解：Cygwin 就像 Linux 各发行版的 apt、yum/dnf、yay、pkg 等包管理工具（但它是一整套环境），可以非常方便地在 Windows 上安装类 Unix 系统的工具和库。

安装过程：

注意事项主要有：

Cygwin 的安装包可以从官网 cygwin.com 下载，直接下载 setup-x86_64.exe 即可。
安装时，在软件包选择界面搜索并勾选 zsh、git、curl 等工具（后面安装 Oh My Zsh 要用到 git 和 curl）。
之后想补装软件包，重新运行一次 setup-x86_64.exe 即可。

配置 Windows Terminal 及系统环境变量

配置 Windows Terminal

概述：打开 Windows Terminal 新增一个配置文件，以便在 Windows Terminal 中使用 Cygwin 的 zsh。

步骤如下：

打开 Windows Terminal。

默认情况下，Windows Terminal 会打开一个 PowerShell 窗口。我们需要新建一个配置文件，以便在 Windows Terminal 中使用 Cygwin 的 zsh。
点击 Windows Terminal 窗口标签栏右侧的下拉菜单，选择“设置”。
在设置窗口左下角，点击“+ 添加新配置文件”。
按照如图所示配置：

需要特别注意的是：

“命令行”（commandline）配置项的值为 Drive:\cygwin64\bin\zsh.exe --login -i，其中 Drive 是驱动器盘符，Drive:\cygwin64 是 Cygwin 的安装目录。--login 表示以登录 shell 启动，会读取 /etc/profile 等文件来设置 HOME、PATH 等环境；-i 表示交互模式。不加有时也能用，但建议加上，环境更完整。
启动目录建议设置到其他磁盘目录，如 D:\YourNameDir，我这里设置的是 D:\project，目的是避免某一天不得不重装系统……又或者 C 盘空间爆红时头疼。当然，这一步也可以在“配置文件” → “默认值” → “启动目录”中进行全局设置，所有配置文件都会生效。
回到左侧的配置列表，在“启动” → “默认配置文件”中选择刚刚新增的配置文件，点击“保存”。之后每次打开 Windows Terminal 都会默认使用这个配置文件（zsh）。

配置系统环境变量

概述：把 Cygwin 的目录加入系统环境变量 Path，这样在 Windows 的其他终端里也能直接调用 Cygwin 的工具。

打开 Windows 的“控制面板”。
点击“系统和安全”。
点击“系统”。
点击“高级系统设置”。
在弹出的“系统属性”窗口中，点击“环境变量”。
在“系统变量”中，找到 Path，点击“编辑”。
点击“新建”，添加 Cygwin 的 bin 目录，如 Drive:\cygwin64\bin，还有 Drive:\cygwin64\sbin。
点击“确定”，保存配置。

在 Windows Terminal 中测试 zsh 可用性

验证配置

打开 Windows Terminal，如果前面配置正确，默认打开的就是 Cygwin 的 zsh 啦。也可以运行下面的命令确认：

1
2


echo $SHELL
zsh --version

第一次启动 zsh 时，可能会出现 zsh-newuser-install 的配置向导，按 q 退出，或者按 0 创建一个空的 ~/.zshrc 即可，反正后面 Oh My Zsh 会接管它。

配置及美化 zsh

安装 Oh My Zsh

概述：安装 Oh My Zsh，以便配置和美化 zsh。

打开 Windows Terminal。

运行以下命令安装 Oh My Zsh：

1
2


# 安装 Oh My Zsh（首选）
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

在中国大陆地区，如果遇到网络问题，可以使用清华大学 TUNA 镜像安装：

1
2
3
4


# 安装 Oh My Zsh（备选）
git clone https://mirrors.tuna.tsinghua.edu.cn/git/ohmyzsh.git
cd ohmyzsh/tools
REMOTE=https://mirrors.tuna.tsinghua.edu.cn/git/ohmyzsh.git sh install.sh

安装完成后，重启 Windows Terminal。
如果你想更换主题，可以在 ~/.zshrc 文件中修改 ZSH_THEME 的值，然后重启 Windows Terminal 查看效果。
如果你想安装插件，可以把插件下载到 $ZSH_CUSTOM/plugins 目录，再在 ~/.zshrc 中启用它，然后重启 Windows Terminal。

安装 zsh-autosuggestions 插件

推荐一个插件：zsh-autosuggestions，它会根据历史命令在输入时给出灰色的建议，按 → 即可采纳。

把插件克隆到 Oh My Zsh 的自定义插件目录（注意目标路径要带上插件名）：

1

git clone --depth=1 https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

编辑 ~/.zshrc 文件，在 plugins 中添加 zsh-autosuggestions：

1
2
3


nano ~/.zshrc
# 修改 plugins 配置项，添加 zsh-autosuggestions 插件，最终修改结果：
plugins=(git zsh-autosuggestions)

让配置生效：重启 Windows Terminal，或者执行 source ~/.zshrc。
最终效果：

引用

Oh My Zsh 官网：ohmyz.sh，GitHub 仓库地址：ohmyzsh/ohmyzsh
zsh-autosuggestions 安装说明
Windows 安装 Zsh 终端
一文搞定 Windows Terminal 设置与 zsh 安装【非 WSL】
MSYS2：A collection of tools and libraries providing you with an easy-to-use environment for building, installing and running native Windows software.

写这篇文章时因为是在 Windows 上操作的……所以同时还遇到了 CRLF 换行符的问题。这个问题在 Linux 下不会遇到，但是在 Windows 下就会遇到，解决方法参考：GitHub Docs：配置 Git 处理行尾
在 Windows 上添加 git-credentials

Windows 升级/版本转换、激活

Thu, 23 Nov 2023 22:48:32 +0800

前言

今天准备在家里的服务器（基于 VMware vSphere 8 虚拟化）上安装一个 Windows Server 2022，以便运行 Sons of the Forest Dedicated Server。

~~走过了很多坑~~

Windows Server 2022 有三个版本：

Windows Server 2022 Standard
Windows Server 2022 Datacenter
Windows Server 2022 Datacenter: Azure Edition

根据需求及实际情况，我选择了 Windows Server 2022 Datacenter。

而对于普通用户来说，可以直接下载到的版本只有评估版。

~~对于学习和使用来说，评估版是完全够用的。~~

评估期限只有 180 天。超过 180 天试用期会发生什么我也没试过，查阅资料说会出现每小时自动关机的现象。

步骤

下载评估版镜像

评估版本下载地址

安装操作系统

此处不赘述，请自行安装，按需求选择版本（Standard / Datacenter，桌面体验 / Server Core）。安装完成后进入系统，以下操作均在系统内进行。

版本转换

评估版可以通过 DISM 原地转换为正式版，不需要重装系统。可以转换的路径如下：

转换前需要注意：

需要管理员权限：右键“开始”菜单，选择 Windows PowerShell（管理员）；
域控制器无法直接转换，需要先降级为普通成员服务器，转换完成后再重新提升；
版本转换不会在 Server Core 和桌面体验之间切换，安装时选的是哪种就是哪种。

在管理员 PowerShell 中执行：

1
2
3


DISM /online /Get-CurrentEdition # 可选 查看当前版本
DISM /online /Get-TargetEditions # 可选 查看可升级版本
DISM /online /Set-Edition:ServerDatacenter /ProductKey:WX4NM-KYWYW-QJJR4-XV3QB-6VM33 /AcceptEula # 升级到零售版

/Set-Edition: 后面填 Get-TargetEditions 列出的目标版本（例如 ServerStandard、ServerDatacenter），/ProductKey: 填对应版本的密钥。整个过程大概是这样：

随后重启系统（可能会自动重启不止一次），完成版本转换。重启后再执行一次 DISM /online /Get-CurrentEdition，确认版本已经不带 Eval 后缀。

激活

Win + R 打开 PowerShell

1
2
3
4
5


slmgr.vbs -upk # 卸载旧的密钥 新安装可忽略 可选
slmgr.vbs -ipk WX4NM-KYWYW-QJJR4-XV3QB-6VM33 # 仅适用于 windows server 2022 datacenter
slmgr.vbs -skms kms-default.cangshui.net # 设置 kms 服务器
slmgr.vbs -ato # 激活
slmgr.vbs -dlv # 激活并查看激活信息 可选

Windows Server 系列：

操作系统版本	KMS 客户端产品密钥
Datacenter	WX4NM-KYWYW-QJJR4-XV3QB-6VM33
Datacenter Azure Edition	NTBV8-9K7Q8-V27C6-M2BTV-KHMXV
Standard	VDYBN-27WPP-V4HQT-9VMD4-VMK7H

引用

附录

操作系统版本	KMS 客户端产品密钥
Windows Server 2022
Datacenter	WX4NM-KYWYW-QJJR4-XV3QB-6VM33
Datacenter Azure Edition	NTBV8-9K7Q8-V27C6-M2BTV-KHMXV
Standard	VDYBN-27WPP-V4HQT-9VMD4-VMK7H
Windows Server 2019
Datacenter	WMDGN-G9PQG-XVVXX-R3X43-63DFG
Standard	N69G4-B89J2-4G8F4-WWYCC-J464C
Essentials	WVDHN-86M7X-466P6-VHXV7-YY726
Windows Server 2016
Datacenter	CB7KF-BWN84-R7R2Y-793K2-8XDDG
Standard	WC2BQ-8NRM3-FDDYY-2BFGV-KHKQY
Essentials	JCKRF-N37P4-C2D82-9YXRT-4M63B
Windows Server（半年频道版本）
Datacenter (20H2, 2004, 1909, 1903, 1809)	6NMRW-2C8FM-D24W7-TQWMY-CWH2D
Standard	N2KJX-J94YW-TQVFB-DG9YT-724CC
Windows 11 和 Windows 10（半年频道版本）
专业版	W269N-WFGWX-YVC9B-4J6C9-T83GX
专业版 N	MH37W-N47XK-V7XM9-C7227-GCQG9
专业工作站版	NRG8B-VKK3Q-CXVCJ-9G2XF-6Q84J
专业工作站版 N	9FNHH-K3HBT-3W4TD-6383H-6XYWF
专业教育版	6TP4R-GNPTD-KYYHQ-7B7DP-J447Y
专业教育版 N	YVWGF-BXNMC-HTQYQ-CPQ99-66QFC
教育版	NW6C2-QMPVW-D7KKK-3GKT6-VCFB2
教育版 N	2WH4N-8QGBV-H22JP-CT43Q-MDWWJ
企业版	NPPR9-FWDCX-D2C8J-H872K-2YT43
企业版 N	DPH2V-TTNVB-4X9Q3-TJR4H-KHJW4
企业版 G	YYVX9-NTFWV-6MDM3-9PT4T-4M68B
企业版 G N	44RPN-FTY23-9VTTB-MP9BX-T84FV
Windows 10 (LTSC/LTSB 版本)
企业版 LTSC 2021	M7XTQ-FN8P6-TTKYV-9D4CC-J462D
企业版 N LTSC 2021	92NFX-8DJQP-P6BBQ-THF9C-7CG2H
企业版 LTSB 2016	DCPHK-NFMTC-H88MJ-PFHPY-QJ4BJ
企业版 N LTSB 2016	QFFDN-GRT3P-VKWWX-X7T3R-8B639
企业版 2015 LTSB	WNMTR-4C88C-JK8YV-HQ7T2-76DF9
企业版 2015 LTSB N	2F77B-TNFGY-69QQF-B8YKP-D69TJ
早期版本的 Windows Server
1803 Datacenter	2HXDN-KRXHB-GPYC7-YCKFJ-7FVDG
1803 Standard	PTXN8-JFHJM-4WC78-MPCBR-9W4KR
1709 Datacenter	6Y6KB-N82V8-D8CQV-23MJW-BWTG6
1709 Standard	DPCNP-XQFKJ-BJF7R-FRC8D-GF6G4
2012 R2 Standard	D2N9P-3P6X9-2R39C-7RTCD-MDVJX
2012 R2 Datacenter	W3GGN-FT8W3-Y4M27-J84CP-Q3VJ9
2012 R2 Essentials	KNC87-3J2TX-XB4WP-VCPJV-M4FWM
2012	BN3D2-R7TKB-3YPBD-8DRP2-27GG4
2012 N	8N2M2-HWPGY-7PGT9-HGDD8-GVGGY
2012 单语言版	2WN2H-YGCQR-KFX6K-CD6TF-84YXQ
2012 特定国家/地区版	4K36P-JN4VD-GDC6V-KDT89-DYFKP
2012 Standard	XC9B7-NBPP2-83J2H-RHMBY-92BT4
2012 MultiPoint 标准版	HM7DN-YVMH3-46JC3-XYTG7-CYQJJ
2012 MultiPoint 高级版	XNH6W-2V9GX-RGJ4K-Y8X6F-QGJ2G
2012 Datacenter	48HP8-DN98B-MYWDG-T2DCC-8W83P
2012 Essentials	HTDQM-NBMMG-KGYDT-2DTKT-J2MPV
2008 R2 Web 版	6TPJF-RBVHG-WBW2R-86QPH-6RTM4
2008 R2 HPC 版	TT8MH-CG224-D3D7Q-498W2-9QCTX
2008 R2 标准版	YC6KT-GKW9T-YTKYR-T4X34-R7VHC
2008 R2 企业版	489J6-VHDMP-X63PK-3K798-CPX3Y
2008 R2 Datacenter	74YFP-3QFB3-KQT8W-PMXWJ-7M648
Itanium 系统的 2008 R2	GT63C-RJFQ3-4GMB6-BRFB9-CB83V
2008 Server Web 版	WYR28-R7TFJ-3X2YQ-YCY4H-M249D
2008 标准版	TM24T-X9RMF-VWXK6-X8JC9-BFGM2
不带 Hyper-V 的 2008 标准版	W7VD6-7JFBR-RX26B-YKQ3Y-6FFFJ
2008 企业版	YQGMW-MPWTJ-34KDK-48M3W-X4Q6V
不带 Hyper-V 的 2008 企业版	39BXF-X8Q23-P2WWT-38T2F-G3FPG
2008 HPC	RCTX3-KWVHP-BR6TB-RB6DM-6X7HP
2008 Datacenter	7M67G-PC374-GR742-YH8V4-TCBY3
不带 Hyper-V 的 2008 数据中心版	22XQ2-VRXRG-P8D42-K34TD-G3QQC
Itanium 系统的 2008	4DWFP-JF3DJ-B7DTH-78FJB-PDRHK
早期版本的 Windows
8.1 专业版	GCRJD-8NW9H-F2CDX-CCM8D-9D6T9
8.1 专业版 N	HMCNV-VVBFX-7HMBH-CTY9B-B4FXY
8.1 企业版	MHF9N-XY6XB-WVXMC-BTDCT-MKKG7
8.1 企业版 N	TT4HM-HN7YT-62K67-RGRQJ-JFFXW
Windows 8 专业版	NG4HW-VH26C-733KW-K6F98-J8CK4
Windows 8 专业版 N	XCVCF-2NXM9-723PB-MHCB7-2RYQQ
Windows 8 企业版	32JNW-9KQ84-P47T8-D8GGY-CWCK7
Windows 8 企业版 N	JMNMF-RHW7P-DMY6X-RF3DR-X2BQT
Windows 7 专业版	FJ82H-XT6CR-J8D7P-XQJJ2-GPDD4
Windows 7 专业版 N	MRPKT-YTG23-K7D7T-X2JMM-QY7MG
Windows 7 专业版 E	W82YF-2Q76Y-63HXB-FGJG9-GF7QX
Windows 7 企业版	33PXH-7Y6KF-2VJC9-XBBR8-HVTHH
Windows 7 企业版 N	YDRBP-3D83W-TY26F-D46B2-XCKRJ
Windows 7 企业版 E	C29WB-22CC8-VJ326-GHFJW-H9DH4
Windows Vista
商用版	YFKBB-PQJJV-G996G-VWGXY-2V3X8
商用版 N	HMBQG-8H2RH-C77VX-27R82-VMQBT
企业版	VKK3X-68KWM-X2YGT-QR4M6-4BWMV
企业版 N	VTC42-BM838-43QHV-84HX6-XJXKV