win10系統Docker怎么搭建設備共享平臺stf

# Win10系統Docker怎么搭建設備共享平臺STF

## 前言

STF（Smartphone Test Farm）是一個開源的移動設備管理平臺，支持遠程調試、監控和共享Android設備。通過Docker容器化部署可以快速搭建環境，本文將詳細介紹在Windows 10系統下使用Docker部署STF的全過程。

---

## 一、環境準備

### 1. 系統要求
- Windows 10 Pro/Enterprise（需支持Hyper-V）
- 至少8GB內存（建議16GB）
- 開啟虛擬化技術（BIOS中啟用VT-x）

### 2. 必要軟件安裝
1. **Docker Desktop for Windows**  
   下載地址：[https://www.docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop)  
   安裝時需勾選"Use Windows containers"選項

2. **WSL 2（Windows Subsystem for Linux）**  
   以管理員身份運行PowerShell執行：
   ```powershell
   wsl --install

1. ADB工具
   建議通過Android Studio安裝或單獨下載Platform Tools

二、Docker環境配置

1. 啟用Linux容器模式

1. 右鍵Docker圖標選擇”Switch to Linux containers”
2. 驗證是否切換成功：

   
   docker info | grep OSType
   

   應輸出OSType: linux

2. 共享驅動器設置

1. 打開Docker設置 → Resources → File Sharing
2. 添加項目存放目錄（如C:\stf）

3. 修改Docker資源分配

建議配置： - CPUs: 4核+ - Memory: 6GB+ - Swap: 1GB

三、STF服務部署

1. 獲取STF鏡像

docker pull openstf/stf:latest
docker pull sorccu/adb:latest
docker pull rethinkdb:latest
docker pull openstf/ambassador:latest
docker pull nginx:alpine

2. 創建Docker網絡

docker network create --subnet 172.18.0.0/16 stf-net

3. 啟動RethinkDB數據庫

docker run -d --name rethinkdb \
  --net stf-net \
  -v /srv/rethinkdb:/data \
  rethinkdb:latest

4. 部署ADB服務

docker run -d --name adb \
  --net stf-net \
  -v /dev/bus/usb:/dev/bus/usb \
  --privileged \
  sorccu/adb:latest

5. 啟動STF主服務

docker run -d --name stf \
  --net stf-net \
  -e "SECRET=YOUR_SECRET_KEY" \
  -p 7100:7100 \
  openstf/stf:latest stf local --public-ip YOUR_WINDOWS_IP

6. 添加Nginx反向代理（可選）

docker run -d --name nginx \
  --net stf-net \
  -p 80:80 \
  -v /path/to/nginx.conf:/etc/nginx/nginx.conf \
  nginx:alpine

四、設備連接配置

1. USB設備識別問題解決

1. 修改Windows注冊表：

   
   [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\usbperf]
   "Start"=dword:00000004
   

2. 安裝USB設備重定向工具

2. ADB設備授權

# 進入ADB容器
docker exec -it adb bash

# 查看設備列表
adb devices

# 授權設備
adb kill-server && adb start-server

五、訪問與使用

1. 瀏覽器訪問：http://localhost:7100

2. 首次登錄需使用以下任意賬號：

   • 管理員：admin@example.com / admin
   • 普通用戶：user@example.com / user

3. 設備共享流程：

   • 管理員分配設備權限
   • 用戶通過Web界面遠程操作
   • 支持實時屏幕投影、ADB調試等

六、常見問題解決

1. 容器啟動失敗

錯誤示例：

stf_1 | ERROR: Unable to connect to RethinkDB

解決方案：

docker network inspect stf-net
docker restart rethinkdb

2. 設備離線問題

檢查步驟： 1. 確認USB調試已開啟 2. 重新插拔設備 3. 查看ADB容器日志：

   docker logs -f adb

3. 性能優化建議

1. 限制容器資源：

   
   docker update --cpus 2 --memory 4g stf
   

2. 使用SSD存儲
3. 關閉不必要的Windows服務

七、進階配置

1. 集群化部署

修改啟動命令：

docker run -d --name stf \
  --net stf-net \
  -e "STF_PROVIDERS_MAX_CONCURRENT=5" \
  -e "STF_PROVIDERS_FOREVER=true" \
  openstf/stf stf provider \
  --name "win10-provider" \
  --connect-sub tcp://YOUR_IP:7250 \
  --connect-push tcp://YOUR_IP:7270 \
  --storage-url http://YOUR_IP/ \
  --public-ip YOUR_PUBLIC_IP

2. 數據持久化

docker volume create stf-data
docker run -d --name stf \
  -v stf-data:/data \
  openstf/stf:latest

3. HTTPS配置

使用Let’s Encrypt證書：

server {
  listen 443 ssl;
  ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
  location / {
    proxy_pass http://stf:7100;
  }
}

結語

通過Docker在Win10系統部署STF，雖然需要解決USB設備識別等Windows特有問題，但容器化方案大幅降低了環境配置復雜度。建議生產環境配合Linux服務器使用，Windows方案更適合開發測試場景。遇到問題可查閱STF官方文檔或社區討論。

注：本文所有命令需在PowerShell或WSL終端中執行，YOUR_WINDOWS_IP需替換為實際本機IP “`

文章共計約1750字，包含完整的部署流程和常見問題解決方案，采用Markdown格式編寫，可直接用于文檔發布。