docs/zh_cn/tutorials/windows.md
:::tip 环境依赖 在 Windows 系统上，JuiceFS 依赖 WinFsp 实现文件系统的挂载。你可以在 WinFsp 源码仓库 下载最新版本，安装后建议重启计算机，以确保所有组件正常加载。 :::
安装文档 介绍了在 Windows 上安装 JuiceFS 客户端的多种方式，这里我们展开介绍手动安装方式。
在项目仓库的 Release 页面 下载最新版本的 JuiceFS 客户端，例如 juicefs-1.3.0-windows-amd64.tar.gz。
为了便于管理，建议在系统中创建一个专用的目录来存放 JuiceFS 客户端程序。例如，可以在 C:\ 目录下创建一个名为 juicefs 的文件夹，将解压后的 juicefs.exe 客户端程序放入该目录。
为了在命令行中方便地使用 juicefs 命令，需要将 JuiceFS 客户端所在的目录添加到系统的环境变量中。具体操作如下：
Path 的变量，选中后点击“编辑”；C:\juicefs；安装完成后，可以通过命令行验证 JuiceFS 客户端是否安装成功。打开命令提示符（CMD）或 PowerShell，输入以下命令：
juicefs version
如果安装成功，你应该能看到类似以下的输出：
juicefs version 1.3.0+2025-07-03.30190ca1094d2
创建和挂载 JuiceFS 文件系统的步骤与其他操作系统类似，但需要注意 Windows 上的命令行语法和路径格式。
juicefs format --storage oss `
--bucket https://your-bucket.oss-cn-region.aliyuncs.com `
--access-key your-access-key `
--secret-key your-secret-key `
redis://your-redis-host:6379/0 `
mywinfs
与 Linux 系统不同，Windows 上的命令行需要使用反引号（`）来换行。
在 Windows 上，挂载点需要指定一个未被占用的盘符（如 X、Y、Z 等）。这与 Linux 和 macOS 上的挂载方式不同，因为这些系统是将文件系统挂载到目录中。
juicefs mount -d redis://your-redis-host:6379/0 X:
从安全性的角度出发，为了避免明文输入密码，可以通过设置环境变量来存储敏感信息。这样在挂载文件系统或启用 S3 Gateway 时无需填写密码，客户端会自动从环境变量中读取。
以下是在 Windows 上使用 JuiceFS 时常用的环境变量：
| 环境变量名 | 说明 |
|---|---|
META_PASSWORD | 元数据引擎密码 |
MINIO_ROOT_USER | S3 网关 Access Key |
MINIO_ROOT_PASSWORD | S3 网关 Secret Key |
可以直接在命令行设置这些环境变量：
set META_PASSWORD=your_password
set MINIO_ROOT_USER=your_access_key
set MINIO_ROOT_PASSWORD=your_secret_key
但这样的设置方式仅在当前命令行会话中有效，关闭窗口后环境变量失效，需重新设置。
如果希望在每次启动 Windows 时都能自动加载这些环境变量，可以通过系统环境变量设置来实现。
打开系统环境变量设置
Win + S，搜索并打开“编辑系统环境变量”。新建系统级环境变量
META_PASSWORD验证环境变量
重新打开终端，尝试不带密码挂载文件系统。如果能够成功挂载，则说明环境变量已生效。
通过 Windows 计划任务实现开机自动挂载有多种方式，这里介绍通过“任务计划程序”设置的方法。
打开“任务计划程序”，点击“创建任务”。
在“常规”选项卡中，设置任务名称（如 JuiceFS_AutoMount），并勾选“使用最高权限运行”。
切换到“触发器”选项卡，点击“新建”，选择“系统启动时”作为触发条件。
切换到“操作”选项卡，点击“新建”，填写以下信息：
C:\juicefs\juicefs.exe）。在“条件”选项卡中，勾选“仅当网络连接可用时”，以确保挂载操作在网络可用时执行。
点击“确定”保存任务。
注意事项：