Skip to content

Surya-Raghuram/Linux-Proxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›œ Linux Proxy Applier - IIITA

Simple scripts to quickly set and remove system-wide proxy settings on GNU/Linux systems.

⚠️ Please read carefully before using.


πŸ“‹ Before You Start

  • Backup your /etc/environment file:
    sudo cp /etc/environment ~/environment.backup

Do not run these scripts using sudo.

⚠️ Currently tested and supported only on Debian-based distributions (Ubuntu, Kubuntu, Pop!_OS, Linux Mint, etc.) and on Arch-based distributions (Arch, Manjaro, EndeavourOS).
Other distros like Fedora, or openSUSE are not yet supported.

πŸš€ How to Use

  • Go to the directory for your distro (e.g., Arch/ or Debian/)
  • Go to the directory that your system is currently using
  • Set Proxy:
    ./apply_proxy
    

You’ll be asked to enter the proxy hostname.

  • Remove Proxy:
    ./remove_proxy
    

πŸ–₯️ If you are using KDE Plasma, enable: System Settings β†’ Network β†’ Settings β†’ Proxy β†’ Use system proxy configuration

🌎 Run Scripts from Anywhere

  • Instead of Distro, use your current distro, Arch/ or Debian/
  • If you want to use apply_proxy and remove_proxy globally, add them to your ~/.local/bin/:
    mkdir -p ~/.local/bin
    
    curl https://raw.githubusercontent.com/Surya-Raghuram/Linux-Proxy/main/linux-proxy/{Distro}/apply_proxy > ~/.local/bin/apply_proxy && chmod +x ~/.local/bin/apply_proxy
    curl https://raw.githubusercontent.com/Surya-Raghuram/Linux-Proxy/main/linux-proxy/{Distro}/remove_proxy > ~/.local/bin/remove_proxy && chmod +x ~/.local/bin/remove_proxy
    

βœ… After this, you can run apply_proxy or remove_proxy from any directory!

πŸ” What the Scripts Modify When you apply proxy, the script updates:

  • /etc/environment
    
  • It also updates some other popular packags that are used, the packages it supports are:
    • apt/ pacman
    • snap
    • git
    • npm

⚑ Important Warnings

Modifying /etc/environment is risky. Always keep a backup.

Understand what the script does before running it.

If something goes wrong, it's on you β€” use responsibly.

πŸ“ TODO

  • Add support for Arch-based distros (Manjaro, EndeavourOS, Arch Linux)
  • Add support for Fedora/RHEL/CentOS (DNF/YUM proxy configs)
  • Add GNOME/KDE desktop environment proxy integration
  • Export proxy settings in shell configs (~/.bashrc, ~/.zshrc, etc.)
  • Add dry-run mode + rollback option for safety
  • Provide .deb and .rpm packages for easier installation

πŸ“’ Suggestions or Issues? Feel free to create an issue on this repository.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages