Skip to content

Provision your proxy server from your local with simple commands.๐Ÿ˜Ž

License

Notifications You must be signed in to change notification settings

100010/proproxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

43 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Proproxy

Make faster to deploy your simple proxy server.

Description

Proproxy installs squid into your server and sets firewall. You can specify ip and port which can access your server though firewall.

Links

Installation

Add this line to your application's Gemfile:

gem 'proproxy'

And then execute:

$ bundle

Or install it yourself as:

$ gem install proproxy

Usage

you need only 4 arguments.

  • your server ip
  • your server ssh port
  • your ip what accesses to proxy server
  • your port to use proxy server though firewall
server = Proproxy::Server.new(:ubuntu, 'xxx.xxx.xxx.xxx', 22)
server.provision
server.update_ip_table('yyy.yyy.yyy.yyy', 33) # 33 is the port to use proxy server though firewall

Proproxy::Server#initialize method called, ssh access will start and connected your server. Proproxy::Server#provision method installs squid into your server and sets squid.conf and iptables default setting. Proproxy::Server#update_ip_table method sets your ip table settings.

options

If you want to specify your ssh key path, or username

server = Proproxy::Server.new(:ubuntu, 'xxx.xxx.xxx.xxx', 22, ssh_path: 'PATH_TO_YOUR_SSH_KEY', username: 'USERNAME')

Or your proxy server can be accessed port 22 by default, you can deny ssh access as:

server.update_ip_table('yyy.yyy.yyy.yyy', 33, with_ssh_port: false)

You can control squid behavior from your local as:

server.clear_squid_cache
server.stop_squid
server.start_squid
server.restart_squid
server.configure_ip_table # configures current ip settings

Warning

Since I just released it, only ubuntu 16.04 can be used. If you missed your ip or ssh settings, the server can't be accessed eternally.

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/100010/proproxy. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

MIT License.

About

Provision your proxy server from your local with simple commands.๐Ÿ˜Ž

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published