SoraWatermarkCleaner 完整安装教程：Windows 与 Linux 双系统指南

本教程将详细介绍如何在 Windows 和 Linux 系统上安装并运行 SoraWatermarkCleaner 项目，帮助你快速去除 Sora 生成视频中的水印。

【银月是射箭小能手，啊对对对】 https://www.bilibili.com/video/BV1WBqdBsE1f/

📋 目录

项目简介
环境要求
[Windows 安装指南](#Windows 安装指南)
[Linux 安装指南](#Linux 安装指南)
启动与使用
常见问题解答

项目简介

SoraWatermarkCleaner 是一个基于 Streamlit 的 Web 应用，用于去除 Sora AI 生成视频中的水印。项目使用 Python 开发，通过 uv 包管理器进行依赖管理，提供简洁直观的用户界面。

项目地址：https://github.com/linkedlist771/SoraWatermarkCleaner

环境要求

组件	要求
操作系统	Windows 10/11 或 Linux（Ubuntu 20.04+、CentOS 7+ 等）
Python	3.8+ （uv 会自动管理）
Git	最新版本
网络	能够访问 GitHub 和 PyPI

Windows 安装指南

第一步：安装 uv 包管理器

uv 是由 Astral 开发的高性能 Python 包管理器，比传统的 pip 快 10-100 倍。

打开 PowerShell（以管理员身份运行），执行以下命令：

powershell 复制代码

irm https://astral.sh/uv/install.ps1 | iex

安装完成后，关闭并重新打开 PowerShell，验证安装：

powershell 复制代码

uv --version

如果显示版本号（如 uv 0.5.x），说明安装成功。

第二步：克隆项目

选择一个合适的目录存放项目，建议放在用户目录下：

powershell 复制代码

cd C:\Users\你的用户名

git clone https://github.com/linkedlist771/SoraWatermarkCleaner.git

cd SoraWatermarkCleaner

第三步：安装依赖

使用 uv 同步安装所有依赖：

powershell 复制代码

uv sync

uv 会自动创建虚拟环境并安装所有必需的包，这个过程通常只需要几秒钟。

第四步：激活虚拟环境

powershell 复制代码

.venv\Scripts\Activate.ps1

⚠️ 遇到执行策略错误？

如果出现类似 "无法加载文件...因为在此系统上禁止运行脚本" 的错误，请先执行：

powershell 复制代码

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后再次尝试激活虚拟环境。

第五步：启动应用

powershell 复制代码

streamlit run app.py

浏览器会自动打开 http://localhost:8501，即可开始使用。

Linux 安装指南

第一步：安装 uv 包管理器

在终端中执行：

bash 复制代码

curl -LsSf https://astral.sh/uv/install.sh | sh

安装完成后，刷新环境变量：

bash 复制代码

# 如果使用 bash
source ~/.bashrc

# 如果使用 zsh
source ~/.zshrc

验证安装：

bash 复制代码

uv --version

第二步：克隆项目

bash 复制代码

# 进入主目录或你选择的目录
cd ~

# 克隆项目
git clone https://github.com/linkedlist771/SoraWatermarkCleaner.git

# 进入项目目录
cd SoraWatermarkCleaner

第三步：安装依赖

bash 复制代码

uv sync

第四步：激活虚拟环境

bash 复制代码

source .venv/bin/activate

激活成功后，命令行前面会出现 (.venv) 标识。

第五步：启动应用

本地使用：

bash 复制代码

streamlit run app.py

远程服务器使用（允许外部访问）：

bash 复制代码

streamlit run app.py --server.port 8501 --server.address 0.0.0.0

通过 http://服务器IP:8501 访问应用。

启动与使用

基本启动命令对比

操作	Windows (PowerShell)	Linux (Bash)
激活虚拟环境	`.venv\Scripts\Activate.ps1`	`source .venv/bin/activate`
启动应用	`streamlit run app.py`	`streamlit run app.py`
退出虚拟环境	`deactivate`	`deactivate`

服务器后台运行（仅 Linux）

如果需要在关闭终端后继续运行，可以使用以下方法：

方法一：使用 nohup

bash 复制代码

nohup streamlit run app.py --server.port 8501 --server.address 0.0.0.0 > output.log 2>&1 &

查看日志：

bash 复制代码

tail -f output.log

方法二：使用 screen

bash 复制代码

# 创建新的 screen 会话
screen -S sora

# 在 screen 中启动应用
streamlit run app.py --server.port 8501 --server.address 0.0.0.0

# 按 Ctrl+A 然后按 D 分离会话
# 重新连接会话
screen -r sora

方法三：使用 tmux

bash 复制代码

# 创建新的 tmux 会话
tmux new -s sora

# 启动应用
streamlit run app.py --server.port 8501 --server.address 0.0.0.0

# 按 Ctrl+B 然后按 D 分离会话
# 重新连接会话
tmux attach -t sora

常见问题解答

Q1: uv 安装失败怎么办？

Windows：确保 PowerShell 以管理员身份运行，并检查网络连接。

Linux：确保已安装 curl：

bash 复制代码

sudo apt install curl  # Debian/Ubuntu
sudo yum install curl  # CentOS/RHEL

Q2: git clone 速度太慢？

可以使用镜像源：

bash 复制代码

git clone https://github.moeyy.xyz/https://github.com/linkedlist771/SoraWatermarkCleaner.git

或者配置 Git 代理。

Q3: 端口被占用怎么办？

更换端口启动：

bash 复制代码

streamlit run app.py --server.port 8888

查看端口占用情况：

Windows:

powershell 复制代码

netstat -ano | findstr :8501

Linux:

bash 复制代码

lsof -i :8501
# 或
netstat -tlnp | grep 8501

Q4: Linux 服务器防火墙阻止访问？

Ubuntu/Debian (ufw)：

bash 复制代码

sudo ufw allow 8501
sudo ufw reload

CentOS/RHEL (firewalld)：

bash 复制代码

sudo firewall-cmd --permanent --add-port=8501/tcp
sudo firewall-cmd --reload

Q5: 如何更新项目？

bash 复制代码

cd SoraWatermarkCleaner
git pull origin main
uv sync

Q6: 依赖安装报错？

尝试清理缓存后重新安装：

bash 复制代码

uv cache clean
uv sync --reinstall

快速参考卡片

Windows 完整流程

powershell 复制代码

# 1. 安装 uv
irm https://astral.sh/uv/install.ps1 | iex

# 2. 重启 PowerShell 后克隆项目
cd C:\Users\你的用户名
git clone https://github.com/linkedlist771/SoraWatermarkCleaner.git
cd SoraWatermarkCleaner

# 3. 安装依赖
uv sync

# 4. 激活并启动
.venv\Scripts\Activate.ps1
streamlit run app.py

Linux 完整流程

bash 复制代码

# 1. 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

# 2. 克隆项目
cd ~
git clone https://github.com/linkedlist771/SoraWatermarkCleaner.git
cd SoraWatermarkCleaner

# 3. 安装依赖
uv sync

# 4. 激活并启动
source .venv/bin/activate
streamlit run app.py --server.port 8501 --server.address 0.0.0.0