{"id":26760,"library":"awscli-plugin-s3-proxy","title":"AWS CLI S3 Proxy Plugin","description":"A plugin for the AWS CLI that allows using an HTTP proxy for S3 requests only, without affecting other AWS service calls. Latest version is 0.5. Low release cadence; last updated in 2018.","status":"active","version":"0.5","language":"python","source_language":"en","source_url":"https://github.com/nowak-ninja/awscli-plugin-s3-proxy","tags":["awscli","plugin","s3","proxy","aws"],"install":[{"cmd":"pip install awscli-plugin-s3-proxy","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required as the base CLI tool that the plugin attaches to","package":"awscli","optional":false}],"imports":[{"note":"Import the module to register the plugin; no direct symbol usage needed.","symbol":"awscli_plugin_s3_proxy","correct":"import awscli_plugin_s3_proxy"}],"quickstart":{"code":"aws configure set plugins.s3_proxy awscli-plugin-s3-proxy\naws configure set s3_proxy.url http://your-proxy:8080\nexport AWS_S3_PROXY=http://your-proxy:8080","lang":"python","description":"Enable the plugin via AWS CLI configuration or environment variable. Then S3 requests go through the proxy."},"warnings":[{"fix":"Use AWS CLI v1 or use the AWS CLI's built-in proxy configuration for all services.","message":"Plugin requires awscli version 1.x; not compatible with AWS CLI v2 (which does not support plugins in the same way).","severity":"breaking","affected_versions":"awscli >=2.0"},{"fix":"Ensure you only expect S3 traffic to be proxied; do not rely on this plugin to proxy other API calls.","message":"The plugin only proxies S3 requests if the URL starts with 's3://' or the service is 's3'. Other AWS service calls are unaffected.","severity":"gotcha","affected_versions":"all"},{"fix":"Use consistent configuration; either use the config file or the env var, not both with different values.","message":"If you set the proxy via environment variable, ensure it does not conflict with the aws configure setting. The plugin checks environment variable first.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Install with `pip install awscli-plugin-s3-proxy` and ensure the Python environment is active.","cause":"Plugin not installed, or Python environment path is incorrect.","error":"ImportError: No module named 'awscli_plugin_s3_proxy'"},{"fix":"Check that the plugin is properly configured in ~/.aws/config: `plugins = s3_proxy` (not awscli-plugin-s3-proxy). The module name is 'awscli_plugin_s3_proxy'.","cause":"The plugin may be interfering if named incorrectly or awscli version is too old.","error":"botocore.exceptions.UnknownServiceError: Unknown service: 's3'\n"},{"fix":"Run `aws configure set s3_proxy.url http://proxy.example.com:8080` or set `AWS_S3_PROXY` environment variable.","cause":"You have enabled the plugin but not set the proxy URL.","error":"ValueError: Missing required parameter: 'url'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}