# 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
```