Initial commit: combine nas_tool, nas_webdav, sync-utils

2026-02-18 22:59:43 +08:00
commit 526c6a5521
77 changed files with 7898 additions and 0 deletions
@@ -0,0 +1,67 @@
+# NAS WebDAV External Access Troubleshooting
+
+This repository contains diagnostic tools and guides to help troubleshoot WebDAV external access issues on NAS systems.
+
+## Problem
+
+WebDAV works on intranet but fails from external networks with "Connection refused" error.
+
+## Quick Start
+
+1. **Run the diagnostic script on your NAS:**
+   ```bash
+   sudo ./diagnose_webdav.sh
+   ```
+
+2. **Check port forwarding:**
+   ```bash
+   ./check_port_forwarding.sh
+   ```
+
+3. **Review the troubleshooting guide:**
+   - See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for detailed solutions
+
+## Files
+
+- `diagnose_webdav.sh` - Comprehensive diagnostic script to check service binding, firewall, and configuration
+- `check_port_forwarding.sh` - Tests port accessibility and provides port forwarding checklist
+- `TROUBLESHOOTING.md` - Detailed troubleshooting guide with common issues and solutions
+
+## Most Common Issues
+
+1. **Service bound to localhost only** - Service listens on `127.0.0.1:5006` instead of `0.0.0.0:5006`
+2. **Firewall blocking port** - Port 5006 not allowed in firewall rules
+3. **Router port forwarding not configured** - External port 5006 not forwarded to NAS internal IP
+4. **Router firewall blocking** - Router firewall blocking incoming connections
+
+## Quick Fix
+
+The most common fix is ensuring your WebDAV service is bound to all interfaces:
+
+**Apache:**
+```apache
+Listen 0.0.0.0:5006
+```
+
+**Nginx:**
+```nginx
+listen 0.0.0.0:5006;
+```
+
+Then configure router port forwarding: External 5006 → Internal NAS IP:5006
+
+## Usage
+
+All scripts should be run on your NAS system:
+
+```bash
+# Make scripts executable (already done)
+chmod +x *.sh
+
+# Run diagnostics
+sudo ./diagnose_webdav.sh
+
+# Check port forwarding
+./check_port_forwarding.sh
+```
+