diff --git a/CUPS打印服务配置交接文档.md b/CUPS打印服务配置交接文档.md
new file mode 100644
index 0000000..21141cb
--- /dev/null
+++ b/CUPS打印服务配置交接文档.md
@@ -0,0 +1,230 @@
+# CUPS 打印服务配置交接文档
+
+## 概述
+
+本文档记录了 CUPS 打印服务的完整配置过程,包括一键安装脚本、中文汉化、远程访问配置等。
+
+---
+
+## 一、一键安装
+
+### Gitee 仓库
+```
+https://gitee.com/yu-yon/S905L3A.git
+```
+
+### 一键安装命令
+```bash
+# 方式一:curl
+curl -fsSL https://gitee.com/yu-yon/S905L3A/raw/master/setup_cups.sh | bash
+
+# 方式二:wget
+wget -qO- https://gitee.com/yu-yon/S905L3A/raw/master/setup_cups.sh | bash
+```
+
+### 脚本功能
+- 自动检测系统架构(x86_64/ARM64/ARMhf)
+- 可选更换国内镜像源(清华大学)
+- 安装 CUPS + Avahi(AirPrint 支持)
+- 多种打印机驱动可选(通用/HP/爱普生/兄弟/奔图)
+- 自动配置远程访问权限
+- 安装中文界面模板
+
+---
+
+## 二、已安装的服务
+
+| 服务 | 端口 | 用途 |
+|------|------|------|
+| CUPS | 631 | 打印服务/Web管理界面 |
+| Avahi | 5353 | mDNS/AirPrint 自动发现 |
+| Samba | 445/139 | Windows SMB 打印共享 |
+| LPR (xinetd) | 515 | LPR 打印协议 |
+
+---
+
+## 三、客户端连接方式
+
+### 局域网环境(推荐)
+
+| 客户端 | 连接方式 |
+|--------|----------|
+| **macOS/iOS** | 自动发现(AirPrint),无需配置 |
+| **Android** | 安装 Mopria Print Service,自动发现 |
+| **Linux** | 自动发现或手动添加 `ipp://IP:631/printers/打印机名` |
+| **Windows** | `\\局域网IP\打印机名` 或 IPP 协议 |
+
+### 公网环境
+
+公网环境较为复杂,可能遇到以下问题:
+- Windows IPP 强制使用 HTTPS,自签名证书不受信任
+- SMB 445 端口可能被 ISP 阻止
+- 需要在云服务器安全组开放相应端口
+
+**公网可用方案:**
+1. **LPR 协议(推荐)**
+ - 端口:515
+ - 队列名:打印机名(如 PDF)
+ - Windows 添加方式:TCP/IP 打印机 → 自定义 → LPR 协议
+
+2. **IPP + 证书信任**
+ - 需要将服务器证书导入 Windows 受信任的根证书
+
+---
+
+## 四、CUPS 管理界面
+
+### 访问地址
+```
+http://服务器IP:631
+https://服务器IP:631
+```
+
+### 登录凭据
+- 用户名:root
+- 密码:SSH 登录密码
+
+### 常用操作
+- 添加打印机:Administration → Add Printer
+- 管理打印队列:Printers → 选择打印机
+- 查看任务:Jobs
+
+---
+
+## 五、重要配置文件
+
+| 文件路径 | 说明 |
+|----------|------|
+| `/etc/cups/cupsd.conf` | CUPS 主配置文件 |
+| `/etc/cups/printers.conf` | 打印机配置 |
+| `/etc/cups/ssl/` | SSL 证书目录 |
+| `/etc/samba/smb.conf` | Samba 配置(SMB 打印共享) |
+| `/etc/xinetd.d/cups-lpd` | LPR 服务配置 |
+| `/usr/share/cups/templates-zh_CN/` | 中文界面模板 |
+
+---
+
+## 六、关键配置说明
+
+### cupsd.conf 关键配置
+```apache
+# 监听所有网络接口
+Listen 0.0.0.0:631
+
+# 允许任何主机名访问
+ServerAlias *
+
+# 禁用强制加密(允许 HTTP)
+DefaultEncryption Never
+
+# 中文界面
+DefaultLanguage zh
+
+# 允许远程访问
+
+ Order allow,deny
+ Allow all
+
+
+# 允许远程打印
+
+ Order allow,deny
+ Allow all
+
+```
+
+### Samba 打印配置
+```ini
+[global]
+printing = cups
+printcap name = cups
+load printers = yes
+
+[printers]
+comment = All Printers
+path = /var/spool/samba
+printable = yes
+guest ok = yes
+```
+
+---
+
+## 七、常用命令
+
+```bash
+# 查看打印机列表
+lpstat -p -d
+
+# 重启 CUPS
+systemctl restart cups
+
+# 查看 CUPS 日志
+tail -f /var/log/cups/error_log
+
+# 重启 Samba
+systemctl restart smbd nmbd
+
+# 重启 LPR 服务
+systemctl restart xinetd
+
+# 检查端口监听
+ss -tlnp | grep -E "631|445|515"
+```
+
+---
+
+## 八、故障排除
+
+### 问题1:Windows 无法连接 IPP 打印机
+**原因**:Windows IPP 客户端强制使用 HTTPS,自签名证书不受信任
+**解决**:使用 LPR 协议或 SMB 协议代替
+
+### 问题2:SMB 连接失败(0x80070035)
+**原因**:445 端口被防火墙/ISP 阻止
+**解决**:
+- 检查云服务器安全组是否开放 445 端口
+- 局域网内通常无此问题
+
+### 问题3:打印任务卡住
+**解决**:
+```bash
+# 取消所有任务
+cancel -a
+# 重启 CUPS
+systemctl restart cups
+```
+
+### 问题4:中文界面不生效
+**解决**:
+```bash
+# 确保中文模板已安装
+ls /usr/share/cups/templates-zh_CN/
+# 检查 locale 设置
+locale -a | grep zh_CN
+```
+
+---
+
+## 九、文件清单
+
+```
+/root/yuyx/B863AV3.2M刷Armbian教程/
+├── setup_cups.sh # 一键安装脚本
+├── cups-templates-zh_CN/ # 中文界面模板(65个文件)
+├── 刷机教程.md # Armbian 刷机教程
+└── CUPS打印服务配置交接文档.md # 本文档
+```
+
+---
+
+## 十、待测试项目
+
+- [ ] 局域网 Windows SMB 连接
+- [ ] 局域网 macOS/iOS AirPrint 自动发现
+- [ ] 局域网 Android Mopria 打印
+- [ ] 真实 USB 打印机连接测试
+
+---
+
+**文档创建时间**:2025-11-30
+**配置环境**:Ubuntu 22.04 / CUPS 2.4
diff --git a/setup_cups.sh b/setup_cups.sh
index 882671d..3662471 100755
--- a/setup_cups.sh
+++ b/setup_cups.sh
@@ -331,6 +331,16 @@ configure_cups() {
sed -i '1a Listen 0.0.0.0:631\nListen /run/cups/cups.sock' /etc/cups/cupsd.conf
fi
+ # 添加 ServerAlias * 允许任何主机名访问
+ if ! grep -q "^ServerAlias" /etc/cups/cupsd.conf; then
+ sed -i '/^Listen.*631/a ServerAlias *' /etc/cups/cupsd.conf
+ fi
+
+ # 禁用强制加密(允许 HTTP 访问)
+ if ! grep -q "^DefaultEncryption" /etc/cups/cupsd.conf; then
+ sed -i '/^ServerAlias/a DefaultEncryption Never' /etc/cups/cupsd.conf
+ fi
+
# 启用网络浏览
if grep -q "^Browsing" /etc/cups/cupsd.conf; then
sed -i 's/^Browsing.*/Browsing Yes/' /etc/cups/cupsd.conf
@@ -338,6 +348,14 @@ configure_cups() {
echo "Browsing Yes" >> /etc/cups/cupsd.conf
fi
+ # 修改 Policy default 允许匿名打印
+ # 找到 块并修改
+ sed -i '//,/<\/Limit>/{
+ s/Order deny,allow/Order allow,deny/
+ /Require user/d
+ /Order/a\ Allow all
+ }' /etc/cups/cupsd.conf
+
# 配置访问权限 - 允许所有网络访问
# 先删除现有的 Location 块,然后重新添加
cat > /tmp/cups_locations.conf << 'EOF'
@@ -359,6 +377,17 @@ configure_cups() {
Order allow,deny
Allow all
+
+# 允许远程打印
+
+ Order allow,deny
+ Allow all
+
+
+
+ Order allow,deny
+ Allow all
+
EOF
# 移除旧的 Location 块