kidpoleon/stalkerhek

stalkerhek - Multi-Profile Stalker IPTV Manager

A lightweight Go-based manager that runs multiple Stalker IPTV portal profiles in parallel, exposing them as local HLS playlist servers and STB proxies for home network streaming.

🚀 Quick Start

bash
# Pull the Docker image
docker pull kidpoleon/stalkerhek:main

# Create data directory
mkdir -p data && echo '[]' > data/profiles.json

# Run with Docker Compose (recommended)
git clone https://github.com/kidpoleon/stalkerhek
cd stalkerhek
docker-compose up -d

Access the WebUI at http://localhost:4400/dashboard

🌟 Features

• Multi-Profile Concurrency: Run multiple Stalker IPTV accounts simultaneously
• Dual Output Per Profile:
  • HLS Playlist Server (for VLC, IPTV players)
  • STB/Portal-Compatible Proxy (for STB-style apps)
• Modern WebUI Dashboard: Dark green theme with real-time monitoring
• Automatic Authentication: Saves profiles → starts immediately
• LAN-Friendly: Run once, stream from any device on your network
• Docker-Optimized: Pre-built images with automated GitHub Actions CI/CD

🐳 Docker Images

Tags

• kidpoleon/stalkerhek:main - Latest build from main branch
• kidpoleon/stalkerhek:latest - Same as main (auto-updated)

Architecture

• linux/amd64 (x86_64)

Image Details

• Base: Alpine Linux 3.20
• Size: ~15MB compressed
• Go Version: 1.21
• Ports: 4400 (WebUI) + dynamic per-profile ports

📁 Docker Compose (Recommended)

yaml
version: '3.8'
services:
  stalkerhek:
    image: kidpoleon/stalkerhek:main
    container_name: stalkerhek
    restart: unless-stopped
    network_mode: host  # Required for dynamic port binding
    environment:
      - STALKERHEK_PROFILES_FILE=/data/profiles.json
    volumes:
      - ./data:/data

🔧 Configuration

Environment Variables

• STALKERHEK_PROFILES_FILE: Path to profiles JSON file (default: /data/profiles.json)

Volume Mounts

• /data - Contains profiles.json with your saved IPTV profiles

Ports

• 4400: WebUI Dashboard
• Dynamic: HLS/Proxy ports per profile (configured in WebUI)

🎯 Usage Workflow

1. Pull & Run: docker-compose up -d
2. Access Dashboard: http://your-server-ip:4400/dashboard
3. Add Profile:
   • Portal URL (e.g., http://example.com/portal.php)
   • MAC address (e.g., 00:1A:79:12:34:56)
   • Choose unique HLS/Proxy ports
4. Use Streams:
   • HLS: http://your-server-ip:HLS_PORT/ (for VLC)
   • Proxy: http://your-server-ip:PROXY_PORT/ (for STB apps)

🔄 Automated Updates

This image is automatically rebuilt and pushed to Docker Hub whenever:

• Changes are pushed to the main branch
• New version tags are created (v*..)
• Daily at 23:25 UTC (scheduled builds)

📊 Health & Metrics

Built-in endpoints:

• GET /health - JSON health status
• GET /metrics - JSON runtime metrics
• GET /info - HTML info page with stats

🛠️ Development

bash
# Build from source
git clone https://github.com/kidpoleon/stalkerhek
cd stalkerhek
docker build -t stalkerhek .

# Run tests
go test ./...

# View logs
docker-compose logs -f

📚 Documentation

• Full Documentation: https://github.com/kidpoleon/stalkerhek#readme
• Video Tutorial: ***
• Source Code: https://github.com/kidpoleon/stalkerhek

⚠️ Important Notes

• For private/home network use only
• Linux host networking recommended for dynamic ports
• Choose unique ports for each profile
• Ensure firewall allows inbound connections on used ports

🤝 Contributing

Contributions are welcome! Please see the https://github.com/kidpoleon/stalkerhek for contributing guidelines.

📄 License

MIT License - See https://github.com/kidpoleon/stalkerhek/blob/main/LICENSE file for details.

🔗 Links

• Docker Hub: https://hub.docker.com/r/kidpoleon/stalkerhek
• GitHub: https://github.com/kidpoleon/stalkerhek
• Issue Tracker: https://github.com/kidpoleon/stalkerhek/issues
• Go Package: https://pkg.go.dev/github.com/kidpoleon/stalkerhek