{"id":17717905,"url":"https://github.com/ohmydevops/nekoray-installer","last_synced_at":"2025-09-24T18:31:26.546Z","repository":{"id":72047708,"uuid":"583492199","full_name":"ohmydevops/nekoray-installer","owner":"ohmydevops","description":"Latest NekoRay Installer with shortcut for most linux distribution","archived":false,"fork":false,"pushed_at":"2024-07-16T14:40:48.000Z","size":29,"stargazers_count":72,"open_issues_count":1,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-07-16T18:05:56.810Z","etag":null,"topics":["censorship","dns","nekoray","shadowsocks","socks","trojan","v2ray","vpn","xray"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ohmydevops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-12-30T00:01:00.000Z","updated_at":"2024-07-16T14:40:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"63250121-aef9-41f3-9e28-f4196dd8566d","html_url":"https://github.com/ohmydevops/nekoray-installer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ohmydevops%2Fnekoray-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ohmydevops%2Fnekoray-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ohmydevops%2Fnekoray-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ohmydevops%2Fnekoray-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ohmydevops","download_url":"https://codeload.github.com/ohmydevops/nekoray-installer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234109499,"owners_count":18781478,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["censorship","dns","nekoray","shadowsocks","socks","trojan","v2ray","vpn","xray"],"created_at":"2024-10-25T14:32:40.009Z","updated_at":"2025-09-24T18:31:26.539Z","avatar_url":"https://github.com/ohmydevops.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Throne Installer \u0026 Management Tools\n\nCross-platform installer and management tools for [Throne](https://github.com/throneproj/Throne) - the next-generation proxy client. This repository provides comprehensive scripts for installation, configuration management, and advanced features across Linux, macOS, and Windows.\n\n---\n\n## 🚀 Quick Start\n\nChoose your platform and run the appropriate command:\n\n### 🐧 Linux\n```bash\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/ohmydevops/nekoray-installer/main/throne-linux.sh)\n```\n\n### 🍎 macOS\n```bash\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/ohmydevops/nekoray-installer/main/throne-mac.sh)\n```\n\n### 🪟 Windows\n```powershell\n# Run in PowerShell as Administrator\nInvoke-Expression (Invoke-WebRequest -Uri \"https://raw.githubusercontent.com/ohmydevops/nekoray-installer/main/windows/installer.ps1\" -UseBasicParsing).Content\n```\n\n---\n\n## 📑 Table of Contents\n\n1. [🐧 Linux Features](#-linux-features)\n2. [🍎 macOS Features](#-macos-features)\n3. [🪟 Windows Features](#-windows-features)\n4. [🔧 Prerequisites](#-prerequisites)\n5. [📖 Detailed Usage](#-detailed-usage)\n\n---\n\n## 🐧 Linux Features\n\nThe Linux script (`throne-linux.sh`) provides a comprehensive menu-driven interface with the following options:\n\n### Menu Options:\n1. **Install Throne** - Downloads and installs the latest Throne release system-wide\n2. **Backup Configuration** - Creates a backup of your current Throne/NekoRay configuration\n3. **Restore Configuration** - Restores configuration from a backup file\n4. **Uninstall** - Completely removes Throne and all related files\n5. **Enable Hotspot** - Creates a Wi-Fi hotspot that routes traffic through Throne\n6. **Disable Hotspot** - Stops the hotspot and removes routing rules\n7. **Exit** - Closes the installer\n\n### Supported Distributions:\n- Ubuntu, Debian, Linux Mint, Pop!_OS (`.deb` packages)\n- Fedora, RHEL, CentOS, Rocky Linux, AlmaLinux (`.rpm` packages)\n\n### Hotspot Features:\n- Automatic Wi-Fi interface detection\n- nftables-based traffic routing\n- NetworkManager integration\n- Secure WPA2 password protection\n\n---\n\n## 🍎 macOS Features\n\nThe macOS script (`throne-mac.sh`) provides a menu-driven interface optimized for macOS:\n\n### Menu Options:\n1. **Install Throne** - Downloads and installs Throne to `/Applications/Throne.app`\n2. **Backup Configuration** - Creates a backup of your Throne/NekoRay configuration\n3. **Restore Configuration** - Restores configuration from a backup file\n4. **Uninstall** - Removes application and preferences (supports both Throne and NekoRay)\n5. **Exit** - Closes the installer\n\n### Features:\n- Native macOS application installation\n- Automatic architecture detection (Intel/Apple Silicon)\n- Homebrew integration for dependencies\n- Spotlight and Launchpad integration\n\n---\n\n## 🪟 Windows Features\n\nThe Windows PowerShell script (`windows/installer.ps1`) provides automated installation:\n\n### Features:\n- Downloads the latest Windows installer executable\n- Automatically launches the official installer\n- Uses native Windows installation methods\n- PowerShell-based for maximum compatibility\n\n### Usage:\nThe script automatically:\n1. Fetches the latest release from GitHub\n2. Downloads the Windows installer\n3. Launches the installer with elevated permissions\n\n---\n\n## 🔧 Prerequisites\n\n### Linux Requirements:\n- One of the supported distributions\n- `curl` (usually pre-installed)\n- Package manager (`dpkg` for Debian-based, `rpm` for Red Hat-based)\n- For hotspot features: `nmcli`, `iw`, `nftables`\n\n### macOS Requirements:\n- macOS 10.15 or later\n- Homebrew (script can install if missing)\n- `curl` and `unzip` (installable via Homebrew)\n\n### Windows Requirements:\n- Windows 10 or later\n- PowerShell 5.1 or later\n- Administrator privileges for installation\n\n---\n\n### Advanced Hotspot Setup (Linux Only)\n\nFor the Wi-Fi hotspot feature to work properly:\n\n1. **Enable Tun Mode in Throne:**\n   - Open Throne GUI\n   - Go to Settings → Enable **Tun Mode**\n\n2. **Required Packages:**\n   ```bash\n   # Debian/Ubuntu\n   sudo apt install network-manager iw nftables\n\n   # Fedora/RHEL\n   sudo dnf install NetworkManager iw nftables\n   ```\n\n3. **Run Hotspot Setup:**\n   - Execute the Linux script and select option 5\n   - Choose a secure password (minimum 8 characters)\n   - The script will create SSID \"ohmythrone\" by default\n\n---\n\n## � Troubleshooting\n\n### Common Issues:\n\n**Linux:**\n- **Permission denied:** Ensure you have sudo privileges\n- **Package not found:** Verify your distribution is supported\n- **Hotspot not working:** Check that NetworkManager is active and Tun Mode is enabled\n\n**macOS:**\n- **App not opening:** Check Gatekeeper settings and allow unidentified developers if needed\n- **Homebrew not found:** The script will offer to install Homebrew automatically\n\n**Windows:**\n- **PowerShell execution policy:** Run `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`\n- **Download failed:** Check internet connection and Windows Defender settings\n\n---\n\n## 📄 License\n\nThis project is open source and available under the MIT License.\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fohmydevops%2Fnekoray-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fohmydevops%2Fnekoray-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fohmydevops%2Fnekoray-installer/lists"}