NikVPN Codespace - Proxy VLESS+xHTTP con GitHub Codespaces

Questo repository ti consente di impostare un proxy VLESS con trasporto xHTTP su GitHub Codespaces in meno di 5 minuti. Completamente gratuito, senza bisogno di un server esterno!

---

✨ Caratteristiche

---

🚀 Come usare (passo dopo passo)

Passo 1: Forkare il repository

1. Accedi a GitHub e Fork questo repository.
2. Oppure, se hai creato il repository, inizia ad usarlo direttamente.

Passo 2: Esegui in Codespaces

1. Clicca sul pulsante Code.
2. Seleziona la scheda Codespaces.
3. Clicca su Create codespace on main.
4. Attendi che il contenitore venga creato (circa 2-3 minuti).

Passo 3: Ottieni il link del proxy

Dopo la creazione, un link VLESS verrà visualizzato nel terminale. Copialo.

Passo 4: Configura la porta (molto importante)

• Nella tua Codespace, apri la scheda PORTS.
• Trova la porta 443.
• Fai clic destro su di essa e seleziona Visibility > Public.

Passo 5: Connessione

Inserisci il link copiato nella tua applicazione proxy.

---

📖 Guida all’uso

🔗 Ottenere e utilizzare il link

Dopo aver eseguito il codespace, il link VLESS verrà visualizzato automaticamente nel terminale. Devi solo:

1. Copiare completamente il link (da vless:// fino alla fine)
2. Inserirlo nella tua applicazione proxy (la maggior parte delle app riconosce il link facendo clic sul pulsante + o Import from clipboard).

---

🔄 Mostra di nuovo il link

Se per qualche motivo hai perso il link o hai bisogno di copiarlo di nuovo, esegui il seguente comando nel terminale del codespace:

show-link.sh

---

📋 Visualizza i log di Xray

Per visualizzare i log del server e assicurarti che funzioni correttamente, inserisci il comando nel terminale:

tmux attach -t nikvpn

Per uscire dalla visualizzazione del log (senza fermare il servizio), premi Ctrl+B e poi D.

---

⏰ Configura il timeout del codespace (per prevenire lo spegnimento)

GitHub Codespaces si spegne automaticamente dopo 30 minuti di inattività.

Metodo 1: Modifica le impostazioni tramite GitHub

Accedi al link:

https://github.com/settings/codespaces

Nella sezione Default idle timeout, seleziona l'opzione desiderata:

• 15 minuti (predefinito)
• 30 minuti
• 60 minuti
• 120 minuti
• 240 minuti (massimo)

Clicca su Salva.

⚠️ Attenzione: il timeout massimo impostabile è di 240 minuti (4 ore).

---

Metodo 2: Metodo stabile e duraturo (obbligatorio per una durata illimitata)

Con la mia esperienza, anche dopo aver modificato le impostazioni del timeout, si presentava ancora la finestra di Keepalive e la connessione si interrompeva. Un'opzione che ha funzionato è:

tmux attach -t nikvpn

Quando esegui questo comando:

• Entro nella sessione tmux dove Xray è in esecuzione.
• Finché questa sessione è connessa, il codespace non si spegne.
• Puoi tenere aperto il terminale o minimizzarlo.

Per uscire dalla sessione tmux (senza fermare il servizio):

• Premi Ctrl+B e poi D.

💡 Suggerimento: se desideri mantenere il codespace acceso a lungo, basta aprire un terminale, eseguire il comando sopra e lasciare aperto il terminale.

---

📱 Client supportati

Il proxy NikVPN è compatibile con la maggior parte dei client popolari che supportano il protocollo VLESS:

---

⚠️ Attenzione: in alcune app potrebbe essere necessario applicare manualmente le seguenti impostazioni:

• Protocollo: VLESS
• Trasporto (Network): xHTTP
• modalità: packet-up
• sicurezza (Security): TLS
• allowInsecure=1

---

🧼 Opzioni IP pulite

L'IP predefinito usato nel link è 94.130.50.12.

Se questo IP è bloccato o ha problemi sulla tua rete, puoi sostituirlo con uno degli IP alternativi qui sotto.

🔽 IP alternativi

---

📝 Come sostituire l'IP

Link principale:

vless://UUID@94.130.50.12:443?encryption=...

Esempio di cambiamento IP:

vless://UUID@63.141.252.203:443?encryption=...

💡 Suggerimento: se nessun IP funziona, puoi utilizzare strumenti per trovare IP puliti di Cloudflare.

---

🆘 Risoluzione dei problemi

---

⚠️ Note importanti

• Ogni mese hai a disposizione 60 ore gratuite.
• Dopo aver finito, ferma il Codespace per non sprecare le ore.
• Se la connessione non va, usa allowInsecure=1.
• In alcune app, potrebbe essere necessario impostare type su xhttp.
• Per mantenere il codespace più a lungo, utilizza tmux attach.

---

🛠️ Sviluppatori

Questo progetto utilizza le seguenti tecnologie:

• Xray-core
• GitHub Codespaces
• Docker

---

📂 Struttura del progetto

nikvpn-codespace/
├── .devcontainer/
│   ├── Dockerfile
│   ├── config.json
│   ├── devcontainer.json
│   ├── setup.sh
│   ├── show-link.sh
│   └── start.sh
├── LICENSE
└── README.md

---

🤝 Sostegno

Se questo progetto ti è stato utile:

• ⭐ Non dimenticare di mettere una stella al repository
• 📺 YouTube: https://youtube.com/@nikvpn4iran
• 📢 Telegram: https://t.me/nikvpn_iran
• 🐛 Segnala problemi negli Issues

---

NikVPN per IRAN – Internet libero per tutti 🇮🇷