` |
---
## 👑 Admin Features
### 📊 Statistics Dashboard
```
📊 BOT STATISTICS
👥 Users & Domains:
• Registered Users: 150
• Active Domains: 45
• Total Subdomains: 1,234
⚡ System Status:
• Uptime: 7d 12h 30m
• Memory Usage: 45.2 MB
• Node.js Version: v20.10.0
🤖 Bot Info:
• Bot Username: @YourWildcardBot
• Last Updated: 2024-01-15 14:30:25
```
### 📢 Broadcast System
Send messages to all registered users:
```
/broadcast 🚨 Scheduled maintenance in 1 hour. All services will be temporarily unavailable.
```
### 👤 User Management
Get detailed user information:
```
/userinfo 123456789
👤 USER INFORMATION
🆔 User ID: 123456789
📱 Telegram: @username (John Doe)
📧 Cloudflare Email: user@example.com
🌐 Custom Domains: 5
📅 Registration: 2024-01-10 09:15:32
```
---
## 🔧 Advanced Configuration
### Custom Domain Setup
Add your own domains to the bot:
```javascript
// config/default.js
DEFAULT_DOMAINS: [
'your-domain.com',
'another-domain.net',
'example.org'
]
```
### Notification Customization
Configure Telegram notifications:
```javascript
NOTIFICATIONS: {
TELEGRAM: {
enabled: true,
groupId: process.env.TELEGRAM_GROUP_ID,
// Custom message templates
templates: {
welcome: '🎉 New user registered: {username}',
domainSetup: '🌐 Wildcard setup: {domain} by {user}'
}
}
}
```
### Rate Limiting Configuration
Prevent abuse with custom rate limits:
```javascript
RATE_LIMITS: {
SETUP_WILDCARD: {
PER_USER: 5, // Max 5 setups per user
COOLDOWN: 3600 // 1 hour cooldown
},
ANALYTICS: {
PER_USER: 10, // Max 10 requests per hour
COOLDOWN: 300 // 5 minutes between requests
}
}
```
---
## 🚀 Deployment
### Production Deployment with PM2
```bash
# Install PM2 globally
npm install -g pm2
# Start bot with PM2
pm2 start index.js --name "autoft-bot-wildcard"
# Enable auto-restart on server reboot
pm2 startup
pm2 save
# Monitor logs
pm2 logs autoft-bot-wildcard
# Restart bot
pm2 restart autoft-bot-wildcard
```
### Environment Setup for Production
```bash
# Set production environment
export NODE_ENV=production
# Increase memory limit if needed
node --max-old-space-size=2048 index.js
```
### Nginx Reverse Proxy (Optional)
If you plan to add webhooks:
```nginx
server {
listen 80;
server_name your-bot-domain.com;
location /webhook {
proxy_pass http://localhost:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}
```
---
## 🛠️ Development
### Project Structure
```
autoft-bot-wildcard/
├── 📁 bin/
│ └── wildcard-bot.js # CLI entry point
├── 📁 config/
│ ├── constants.js # Application constants
│ └── default.js # Default configuration
├── 📁 handlers/
│ ├── adminHandlers.js # Admin command handlers
│ ├── cloudflareHandlers.js # Cloudflare operations
│ ├── configHandlers.js # Configuration management
│ ├── domainHandlers.js # Domain operations
│ └── generalHandlers.js # General bot commands
├── 📁 lib/
│ └── WildcardBot.js # Main bot class
├── 📁 services/
│ ├── CloudflareManager.js # Cloudflare API wrapper
│ └── NotificationService.js # Notification system
├── 📁 utils/
│ ├── fileUtils.js # File operations
│ ├── systemUtils.js # System utilities
│ └── validation.js # Input validation
├── 📁 data/ # Bot data storage
├── .env.example # Environment template
├── index.js # Application entry point
├── package.json # Dependencies
└── README.md # Documentation
```
### Running in Development Mode
```bash
# Clone repository
git clone https://github.com/AutoFTbot/Wildcard-Bot.git
cd Wildcard-Bot
# Install dependencies
npm install
# Copy environment file
cp .env.example .env
# Edit configuration
nano .env
# Start in development mode
npm run dev
```
### Code Style and Linting
```bash
# Run linter
npm run lint
# Fix linting issues
npm run lint:fix
# Format code
npm run format
# Run all checks
npm run check
```
### Testing
```bash
# Test configuration
npm run test:config
# Test notifications
npm run test:notifications
# Test Cloudflare connection
npm run test:cloudflare
```
---
## ❓ FAQ
### **Q: How do I get a Telegram Bot Token?**
A: Message [@BotFather](https://t.me/BotFather) on Telegram, use `/newbot` command, and follow the instructions.
### **Q: Where do I find my Cloudflare Global API Key?**
A: Go to [Cloudflare Dashboard](https://dash.cloudflare.com) → My Profile → API Tokens → Global API Key → View
### **Q: How do I get my Telegram ID?**
A: Message [@userinfobot](https://t.me/userinfobot) on Telegram to get your user ID.
### **Q: Can I use custom domains?**
A: Yes! Add your domains to the `DEFAULT_DOMAINS` array in `config/default.js`.
### **Q: Is there a limit on users or domains?**
A: You can configure limits in `config/default.js`. Default is 5 domains per user.
### **Q: How do I update the bot?**
A: Run `npm update -g autoft-bot-wildcard` for global installations.
### **Q: "autoft-bot-wildcard command not found" error**
This happens when the global installation didn't complete properly:
```bash
# Reinstall globally
npm install -g autoft-bot-wildcard --force
# Clear npm cache if needed
npm cache clean --force
# Check if command is available
which autoft-bot-wildcard
# Alternative: run directly with npx
npx autoft-bot-wildcard
```
---
## 🆘 Troubleshooting
### Common Issues
#### 🔴 Bot not responding
```bash
# Check if bot is running
ps aux | grep node
# Check logs
pm2 logs autoft-bot-wildcard
# Restart bot
pm2 restart autoft-bot-wildcard
```
#### 🔴 "Bot token invalid" error
- Verify your bot token in `.env` file
- Make sure token format is correct: `1234567890:ABCdefGHIjklMNOpqrsTUVwxyz`
- Check if bot was deleted in @BotFather
#### 🔴 Cloudflare API errors
- Verify Global API Key and email in user configuration
- Check if domain is added to Cloudflare account
- Ensure API key has necessary permissions
#### 🔴 Notifications not working
- Verify `TELEGRAM_GROUP_ID` in environment variables
- Make sure bot is added to the notification group
- Check if bot has permission to send messages
#### 🔴 Domain setup fails
- Ensure domain is registered in Cloudflare
- Check DNS propagation status
- Verify Cloudflare account permissions
#### 🔴 Installation fails
- Make sure you have Node.js 16+ installed
- Try clearing npm cache: `npm cache clean --force`
- Use the latest npm version: `npm install -g npm@latest`
### Debug Mode
Enable detailed logging:
```bash
export LOG_LEVEL=debug
npm start
```
### Getting Help
1. Check our [Wiki](https://github.com/AutoFTbot/Wildcard-Bot/wiki)
2. Search [existing issues](https://github.com/AutoFTbot/Wildcard-Bot/issues)
3. Join our [Telegram group](https://t.me/AutoFtBot69)
4. Create a [new issue](https://github.com/AutoFTbot/Wildcard-Bot/issues/new)
---
## 🤝 Contributing
We welcome contributions! Here's how you can help:
### 🐛 Bug Reports
- Use the [issue template](https://github.com/AutoFTbot/Wildcard-Bot/issues/new?template=bug_report.md)
- Include detailed reproduction steps
- Provide relevant logs and screenshots
### ✨ Feature Requests
- Check [existing requests](https://github.com/AutoFTbot/Wildcard-Bot/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
- Use the [feature template](https://github.com/AutoFTbot/Wildcard-Bot/issues/new?template=feature_request.md)
- Explain the use case and benefits
### 💻 Code Contributions
1. Fork the repository
2. Create a feature branch: `git checkout -b feature/amazing-feature`
3. Make your changes and test thoroughly
4. Follow our coding standards (run `npm run lint`)
5. Commit with clear messages: `git commit -m 'Add amazing feature'`
6. Push to your branch: `git push origin feature/amazing-feature`
7. Open a Pull Request
### 📚 Documentation
- Improve existing documentation
- Add examples and use cases
- Translate to other languages
- Create video tutorials
---
## 📈 Roadmap
### 🚀 Upcoming Features
- [ ] **Web Dashboard** - Browser-based management interface
- [ ] **Docker Support** - Containerized deployment
- [ ] **Multi-language** - Support for multiple languages
- [ ] **Advanced Analytics** - Detailed usage statistics
- [ ] **Custom Commands** - User-defined bot commands
- [ ] **Backup System** - Automated data backups
- [ ] **Plugin System** - Extensible architecture
### 🎯 Long-term Goals
- [ ] **Cloud Hosting** - Managed hosting service
- [ ] **Mobile App** - Native mobile application
- [ ] **Enterprise Features** - Advanced business features
- [ ] **API Gateway** - RESTful API interface
---
## 📊 Statistics
---
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
```
MIT License
Copyright (c) 2024 AutoFTbot Team
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
```
---
## 🙏 Acknowledgments
- **Telegraf.js** - Telegram Bot API framework
- **Cloudflare** - DNS and CDN services
- **Node.js Community** - Runtime environment
- **Contributors** - Everyone who helped improve this project
---
## 📞 Support & Community
### 💬 Get Help
[](https://t.me/AutoFtBot69)
[](https://github.com/AutoFTbot/Wildcard-Bot/issues)
### 🌟 Stay Updated
[](https://github.com/AutoFTbot/Wildcard-Bot)
[](https://github.com/AutoFTbot/Wildcard-Bot)
[](https://github.com/AutoFTbot/Wildcard-Bot)
---
**⭐ If this project helped you, please give it a star!**
**Made with ❤️ by the AutoFTbot Team**
[🚀 Get Started Now](https://www.npmjs.com/package/autoft-bot-wildcard) • [📖 Read the Docs](https://github.com/AutoFTbot/Wildcard-Bot/wiki) • [💬 Join Community](https://t.me/AutoFtBot69)