Dockur Windows 虚拟机启动脚本配置指南

背景介绍

在虚拟化环境中，经常需要在Windows虚拟机启动时自动执行特定脚本或任务。Dockur Windows项目提供了一种灵活的机制来实现这一需求，类似于GCP平台上的windows-startup-script-ps1功能。

启动脚本配置方法

首次安装时执行脚本

Dockur Windows支持在虚拟机首次安装时通过以下方式执行脚本：

1. 准备一个install.bat批处理文件
2. 将该文件放置在/storage/oem目录下
3. 虚拟机完成安装后会自动执行该脚本

示例install.bat内容：

@echo off
PowerShell -NoProfile -ExecutionPolicy Bypass -Command "C:\OEM\your_script.ps1"

每次启动时执行脚本

要实现每次启动都执行脚本，可以通过以下两种方式：

1. 启动文件夹方式： 在install.bat中添加命令将脚本复制到Windows启动文件夹：

   copy C:\OEM\your_script.ps1 "C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp\"
   

2. 注册表方式： 通过PowerShell脚本创建注册表项，添加启动项：

   New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run" -Name "MyStartupScript" -Value "C:\OEM\your_script.ps1"
   

调试技巧

1. 日志记录： 在批处理文件中添加日志记录功能：

   @echo off
   set LOGFILE=C:\OEM\batch.log
   call :LOG > %LOGFILE%
   exit /B
   
   :LOG
   PowerShell -NoProfile -ExecutionPolicy Bypass -Command "C:\OEM\your_script.ps1"
   

2. 调试窗口： 在脚本末尾添加暂停命令，便于查看执行结果：

   pause
   或
   timeout /t 30
   

环境变量注入

如果需要每次启动时注入动态变量（如API token），可以通过以下方式实现：

1. 在install.bat中创建计划任务
2. 配置该任务在每次启动时运行
3. 在任务执行的脚本中从外部文件读取token值

示例PowerShell脚本：

$token = Get-Content "C:\OEM\token.txt"
# 使用$token进行后续操作

常见问题解决

1. 脚本未执行：

   • 检查文件是否放置在正确目录
   • 验证脚本权限设置
   • 确认脚本编码格式（建议使用ANSI或UTF-8无BOM）

2. 执行超时：

   • 增加脚本执行超时时间
   • 检查脚本是否有阻塞操作

3. 权限问题：

   • 确保以管理员权限执行脚本
   • 检查用户账户控制(UAC)设置

最佳实践建议

1. 对于复杂脚本，建议先手动测试确认功能正常
2. 关键操作添加错误处理和日志记录
3. 考虑脚本执行对系统启动时间的影响
4. 重要操作添加回滚机制
5. 定期清理日志文件避免磁盘空间占用

通过以上方法，您可以灵活地在Dockur Windows虚拟机中实现各种启动时自动化任务，满足不同场景下的运维需求。