{"id":19585918,"url":"https://github.com/cacti/rrdproxy","last_synced_at":"2025-08-17T07:04:25.077Z","repository":{"id":53815311,"uuid":"52683898","full_name":"Cacti/rrdproxy","owner":"Cacti","description":"RRDTool Proxy","archived":false,"fork":false,"pushed_at":"2025-06-16T12:47:18.000Z","size":665,"stargazers_count":26,"open_issues_count":0,"forks_count":8,"subscribers_count":13,"default_branch":"develop","last_synced_at":"2025-06-29T06:04:32.465Z","etag":null,"topics":["cache","rrdproxy-plugin","rrdtool","rrdtool-proxy"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cacti.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"support-files/rrdtool-proxy.service","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-02-27T19:10:32.000Z","updated_at":"2025-06-16T12:47:22.000Z","dependencies_parsed_at":"2025-06-29T06:14:34.136Z","dependency_job_id":null,"html_url":"https://github.com/Cacti/rrdproxy","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Cacti/rrdproxy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Frrdproxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Frrdproxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Frrdproxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Frrdproxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cacti","download_url":"https://codeload.github.com/Cacti/rrdproxy/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Frrdproxy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270816527,"owners_count":24650825,"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","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cache","rrdproxy-plugin","rrdtool","rrdtool-proxy"],"created_at":"2024-11-11T07:57:46.875Z","updated_at":"2025-08-17T07:04:25.027Z","avatar_url":"https://github.com/Cacti.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# rrdproxy\n\nCacti RRDtool Proxy Server is a standalone proxy interface to Tobi Oetiker's\ngreat RRDtool.\n\nThe main focus of this project is to allow the relocation of RRD files, data\nreplication, support of Cacti Boost and, if needed, the RRDcached daemon. It\nallows system administrators to split Cacti's access resources across machines\nwithout the need for NFS.\n\nDue the fact that updates to files may contain sensitive data and to prevent\nundesired updates, RRDtool proxy utilizes high encrypted connections (RSA2048\nand AES192) with continuously changing keys.  This ensures a secured connection\nbetween the proxy and registered clients and/or other proxies.\n\nA local service port is provided to allow administrators are able to access a\nseparate command line interface which provides easy access to configure and\ndebug the proxy.\n\n## Contribute\n\nGet involved in development by participating in active development on\n[GitHub](https://github.com/Cacti/rrdproxy/).\n\n## Requirements\n\nRRDtool Proxy Server runs on any Unix-based operating system that can meet the\nminimum requirements, though it will perform better with the recommended (or\nhigher).\n\n### Minimum Requirements\n\n- PHP Version 7.2 or higher\n  Installation must include and enable the following modules:\n\n  - Sockets\n\n  - Posix\n\n  - PCntl\n\n  - GMP\n\n  - ZLIB\n\n- RRDtool Version 1.5 or higher\n\n- Cacti Version 1.2.7 or higher\n\n### Recommended Requirements\n\nAll minimum requirements must be met, though the following are more optional:\n\n- PHP Version 7.3 or higher\n  Include all minimum recommendation modules\n\n- RRDtool 1.7 or higher\n\n- Cacti 1.2.7\n\n## Usage\n\nBefore using the RRDtool Proxy Server, you must install the system using the\nsetup wizard which can be run at any point using the -w parameter.\n\n```shell\n php rrdtool-proxy.php --help\n\n RRDtool Proxy v1.2.17\n Copyright (C) 2004-2024 The Cacti Group\n usage: rrdtool-proxy.php [--wizard] [-w] [--version] [-v]\n Optional:\n -v --version   - Display this help message\n -w --wizard    - Start Configuration Wizard\n```\n\nWhen running through the wizard, the status of items will appear on the right\nhand side of the screen.  When an item is successfully completed, the status of\n`[OK]` will be shown in green (when color is supported) as seen below:\n\n```shell\nChecking System Requirements...\n[0.00001] test: operation system supported                                  [OK]\n[0.00007] test: php module 'sockets'                                        [OK]\n[0.00011] test: php module 'posix'                                          [OK]\n```\n\nShould any item have an issue, the status will be displayed as something other\nthan `[OK]` such as `[FAILED]`:\n\n```shell\n[0.40270] read: RRDproxy configuration file                             [FAILED]\n```\n\nStatus Color | Description\n: --- | : ---\nGreen | Success and without issue\nYellow | Warnings and will be ignored, correct the problem if needed\nRed | Errors and will not be ignored, may prevent continuation\n\nWhen the wizard prompts for the various settings that are available, you can\naccept the default value simply by pressing return to accept it. Below are a few\nof these settings and the default values that can be accepted:\n\nSetting | Default | Comment\n: --- | : --- | : ---\nCLI System Prompt | rrdp | Max 8 chars\nIPv4 Listen Addr | 0.0.0.0 | Listen all addr\nClient Proxy Port | 40301 | Connections from a client\nProxy Proxy port | 40302 | Connections from another proxy\nDedicated CLI port | 40303 | Connections to the proxy cli\n\nIf the wizard displays a prompt that requires a response and it has no default,\nyou will be prompted again until a valid response has been entered.\n\n## Command Line Interface\n\nUse '?' or 'help' to get a list of all commands being supported by the proxy or\nhints about missing parameters.  The following shows an example of using the CLI\nto list the available commands to find the version of RRDtool Proxy Server.\n\nNote: that most commands require that the CLI is in privileged mode and this\npassword is encrypted in the configuration so cannot be guessed.  If the\npassword has been forgotten, it can be reset using the RRDtool Proxy\nServer Wizard but the background process will need to be manually terminated.\n\n```\ntelnet localhost 40303\nTrying 127.0.0.1...\nConnected to localhost.\nEscape character is '^]'.\nrrdp\u003e?\n  enable          Turn on privileged commands\n  help            Display help\n  show            Show running system information\n  quit            Close terminal session\n\nrrdp\u003eena Tester12\n\nrrdp# help\n  clear           Clear functions for internal buffers\n  disable         Turn off privileged commands\n  reset           Reset terminal screen\n  set             Configure proxy settings\n  show            Show running system information\n  shutdown        Close all connections and shut down proxy\n  quit            Close terminal session\n\nrrdp# show ?\n  clients         List all trusted client connections\n  counters        Return all system counters\n  cluster         List all trusted cluster peers\n  logging         Display state of logging\n  msr             Display replication state\n  processes       Display running child processes\n  rsa             Show Encryption setup\n  threads         Display currently open connections\n  variables       Show Current Operating configuration\n  version         System software status\n\nrrdp#sh version\n\n#     ___           _   _     __    __    ___     ___\n#    / __\\__ _  ___| |_(_)   /__\\  /__\\  /   \\   / _ \\_ __ _____  ___   _\n#   / /  / _` |/ __| __| |  / \\// / \\// / /\\ /  / /_)/ '__/ _ \\ \\/ / | | |\n#  / /__| (_| | (__| |_| | / _  \\/ _  \\/ /_//  / ___/| | | (_) \u003e  \u003c| |_| |\n#  \\____/\\__,_|\\___|\\__|_| \\/ \\_/\\/ \\_/___,'   \\/    |_|  \\___/_/\\_\\__, |\n#                                                                   |___/\n\n RRDtool Proxy v1.2.17\n Copyright (C) 2004-2024 The Cacti Group\n rrdp uptime is 14 days, 0 hours, 4 minutes, 14 seconds\n Memory usage 0.18872917 % (2026464/1073741824 in bytes)\n a8:29:6a:b7:5d:be:c3:8a:be:13:7a:61:ee:0c:8b:d3\n Process ID: 13996\n Session usage (1/399)\n\n Server IP [192.168.10.10]\n Administration: [localhost       :40303]\n Replication:    [192.168.10.10   :40302]\n Clients:        [192.168.10.10   :40301]\n\nrrdp#\n```\n\n## Planned features\n\n- Data replication\n\n  This is currently being written and has been mostly completed, but it is still\n  being tested and so hasn't been made available yet.\n\n- Proxy stats via SNMP\n\n  A NET-SNMP persistent daemon and MIB needs to written to enabled support of\n  proxy stats via SNMP.  This could lead to an interesting loop of Cacti storing\n  stats for RRDproxy within RRDproxy.\n\n- International language support\n\n  Currently, the RRDproxy wizard and command line interface port are both\n  offering only english as the default language.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcacti%2Frrdproxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcacti%2Frrdproxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcacti%2Frrdproxy/lists"}