NDash - PowerDNS Admin Dashboard

Built with GitHub Copilot (Grok Code Fast 1) - AI-assisted development for enhanced productivity and code quality.

Copyright (c) 2025 NDash Project - All rights reserved.

NDash adalah dashboard administrasi modern untuk PowerDNS yang dibangun dengan Express.js, EJS, Alpine.js, dan Shadcn UI components.

✨ Fitur

• 🎨 Modern UI: Menggunakan Tailwind CSS dengan komponen Shadcn UI
• ⚡ Reactive: Alpine.js untuk interaktivitas yang ringan
• 🔌 PowerDNS API: Integrasi lengkap dengan PowerDNS API
• 📊 Dashboard: Overview statistik dan monitoring
• 🌐 Zone Management: Kelola DNS zones dengan mudah
• 📝 Record Management: CRUD operations untuk DNS records
• 📈 Statistics: Visualisasi statistik server PowerDNS
• ⚠️ Error Handling: Banner notifikasi error dengan tombol retry otomatis
• 🔄 Auto Refresh: Refresh data secara manual dengan loading indicator

🎯 Error Handling

NDash dilengkapi dengan sistem error handling yang user-friendly:

• Error Banner: Muncul secara otomatis ketika ada masalah koneksi ke PowerDNS API
• Detailed Messages: Menampilkan pesan error yang jelas dan actionable
• Retry Button: Tombol retry untuk mencoba koneksi ulang
• Visual Indicators: Status server berubah warna (Online = hijau, Error/Offline = merah)
• Graceful Degradation: UI tetap stabil meskipun backend error

Contoh error yang ditangani:

• ECONNRESET: PowerDNS API tidak berjalan atau tidak dapat dijangkau
• Network Error: Masalah koneksi jaringan
• HTTP 500: Internal server error dari PowerDNS
• Invalid Data: Format data yang tidak sesuai dari API

🌐 Split-Horizon DNS

NDash includes a built-in Split-Horizon DNS Proxy that provides different DNS responses based on client subnet:

Features

• Client-aware responses: Different answers for internal vs external clients
• CIDR subnet support: Configure IP ranges for internal/external networks
• Real-time configuration: Changes apply immediately without restarting
• DNS proxy server: Runs on port 5353 (configurable)

Configuration

{
  "enabled": true,
  "zones": [
    {
      "name": "dionipe.local",
      "internal": [
        {"name": "@", "type": "A", "value": "192.168.203.5"}
      ],
      "external": [
        {"name": "@", "type": "A", "value": "8.8.8.8"}
      ]
    }
  ],
  "subnets": {
    "internal": ["192.168.0.0/16", "10.0.0.0/8", "172.16.0.0/12"],
    "external": ["0.0.0.0/0"]
  }
}

Testing

# Test external response (from 127.0.0.1)
$ dig @127.0.0.1 -p 5353 dionipe.local
# Answer: 8.8.8.8

# Test internal response (from PowerDNS directly)
$ dig @127.0.0.1 dionipe.local  
# Answer: 192.168.203.5

How It Works

1. Client Detection: Proxy identifies client IP and determines if it's internal or external
2. Record Selection: Serves appropriate records based on client type
3. Fallback: Forwards non-Split-Horizon queries to upstream DNS server
4. Real-time Updates: Configuration reloads automatically when changed via web UI

Benchmarks (Local Development)

• Server Response: ~19ms
• HTML Size: ~23KB
• API Response: ~20ms
• Alpine.js Bindings: 76 (optimized)

Further Optimizations

Untuk production deployment, jalankan:

./bundle-resources.sh  # Bundle CDN resources locally

Ini akan mengurangi external requests dan meningkatkan loading speed.

Prerequisites

• Node.js v16 atau lebih tinggi
• PowerDNS server dengan API diaktifkan
• npm atau yarn

Installation

1. Clone atau extract project ini:

cd /opt/ndash

2. Install dependencies:

npm install

3. Copy file konfigurasi dan edit sesuai kebutuhan:

cp .env.example .env
nano .env

4. Konfigurasi file .env:

PORT=3000
NODE_ENV=development

# PowerDNS API Configuration
PDNS_API_URL=http://localhost:8081
PDNS_API_KEY=your-powerdns-api-key-here

# Session Secret
SESSION_SECRET=change-this-to-a-random-secret-key

5. Jalankan aplikasi:

# Development mode (dengan auto-reload)
npm run dev

# Production mode
npm start

6. Buka browser dan akses:

http://localhost:3000

🔧 Konfigurasi PowerDNS

Pastikan PowerDNS API sudah diaktifkan. Edit file konfigurasi PowerDNS (biasanya /etc/powerdns/pdns.conf):

# Enable API
api=yes
api-key=your-secure-api-key-here

# Bind API to localhost (atau IP tertentu)
webserver=yes
webserver-address=0.0.0.0
webserver-port=8081
webserver-allow-from=127.0.0.0/8,::1

Restart PowerDNS setelah mengubah konfigurasi:

systemctl restart pdns

Troubleshooting Authentication

Jika mendapat error Authentication by API Key failed:

1. Periksa API Key: Pastikan api-key di PowerDNS config sama dengan PDNS_API_KEY di .env
2. Periksa webserver-allow-from: Konfigurasi ini harus mengizinkan akses dari IP NDash server
3. Test Direct API: curl -H "X-API-Key: your-key" http://localhost:8081/api/v1/servers
4. Restart Services: Restart PowerDNS dan NDash setelah perubahan config

Environment Variables

# PowerDNS API Configuration
PDNS_API_URL=http://localhost:8081
PDNS_API_KEY=your-powerdns-api-key

# NDash Configuration
PORT=3000
NODE_ENV=development
SESSION_SECRET=your-session-secret

📁 Struktur Project

ndash/
├── lib/
│   └── pdns-client.js      # PowerDNS API client
├── public/
│   ├── css/
│   │   └── style.css       # Custom styles
│   └── js/
│       └── app.js          # Frontend JavaScript
├── views/
│   ├── partials/
│   │   ├── header.ejs      # Header template
│   │   └── footer.ejs      # Footer template
│   ├── index.ejs           # Dashboard page
│   └── error.ejs           # Error page
├── .env.example            # Environment variables template
├── .gitignore             # Git ignore rules
├── package.json           # Project dependencies
└── server.js              # Main application file

🎯 API Endpoints

Servers

• GET /api/servers - Get all servers
• GET /api/servers/:serverId/statistics - Get server statistics

Zones

• GET /api/servers/:serverId/zones - Get all zones
• GET /api/servers/:serverId/zones/:zoneId - Get specific zone
• POST /api/servers/:serverId/zones - Create new zone
• DELETE /api/servers/:serverId/zones/:zoneId - Delete zone

Records

• PATCH /api/servers/:serverId/zones/:zoneId - Update records

🛠️ Development

Running in Development Mode

npm run dev

Ini akan menjalankan aplikasi dengan nodemon yang akan otomatis restart saat ada perubahan file.

Technology Stack

• Backend: Express.js
• View Engine: EJS (Embedded JavaScript)
• Frontend Framework: Alpine.js
• CSS Framework: Tailwind CSS
• UI Components: Shadcn-inspired components
• Icons: Lucide Icons
• HTTP Client: Axios

🔒 Security

• Gunakan HTTPS di production
• Ubah SESSION_SECRET dengan nilai random yang aman
• Jangan expose PowerDNS API ke internet
• Implementasikan authentication jika diperlukan
• Batasi akses API PowerDNS dengan firewall

📝 TODO / Roadmap

• [ ] Authentication & Authorization
• [ ] Record editing interface
• [ ] Bulk operations
• [ ] Search functionality
• [ ] Export/Import zones
• [ ] Activity logs
• [ ] DNSSEC management
• [ ] Multi-server support
• [ ] Dark mode
• [ ] Responsive mobile view improvements

🤝 Contributing

Kontribusi sangat diterima! Silakan fork project ini dan submit pull request.

📄 License

MIT License - lihat file LICENSE untuk detail.

👨‍💻 Author

Created with ❤️ for the PowerDNS community

🐛 Bug Reports

Jika menemukan bug atau masalah, silakan buat issue di repository ini.

💡 Tips

1. Backup: Selalu backup konfigurasi PowerDNS sebelum melakukan perubahan
2. Testing: Test di environment development sebelum deploy ke production
3. Monitoring: Pantau log aplikasi untuk debugging
4. Performance: Gunakan reverse proxy (nginx/apache) di production

📚 Resources

• PowerDNS Documentation
• Express.js Guide
• Alpine.js Documentation
• Tailwind CSS

---

NDash - Modern PowerDNS Administration Made Easy