Skip to content

Commit 2b967db

Browse files
committed
Removed Mirrors information
1 parent a202c8e commit 2b967db

1 file changed

Lines changed: 2 additions & 161 deletions

File tree

docs/MirrorGuidelines.md

Lines changed: 2 additions & 161 deletions
Original file line numberDiff line numberDiff line change
@@ -5,167 +5,8 @@
55
## Mirrors being phased out
66

77
The availability of platforms such as [github](https://github.com) that provide
8-
free hosting for free software such as squid, we will progressively phase out
8+
free hosting for free software such as squid, in January 2025 we have phased out
99
our homegrown mirror platform.
1010

1111
Thanks to all the contributors who supported the project through the years
12-
with donatins of storage and bandwidth!
13-
14-
## historic information
15-
16-
Please ensure all mirrors use **rsync** to replicate their content.
17-
18-
### Informing us about the mirror
19-
20-
Please send **info at squid-cache.org** an email informing us about your
21-
mirror if you are mirroring the FTP server or HTTP website. We will
22-
register it for automatic scanning and list it with our official
23-
download sources so long as it remains an accurate copy.
24-
25-
This email needs to include:
26-
27-
- The URL you are providing for mirror
28-
29-
- For FTP package mirrors the <ftp://> URL and whether you
30-
provide an <http://> alternative URL as well.
31-
32-
- For HTTP package mirrors the <http://> URL.
33-
34-
- For website mirrors the FQDN for the mirror server or proxy
35-
36-
- contact person and email
37-
38-
- they will be notified of any problems with this server found by
39-
the automated testing.
40-
41-
- optional: this same email address should also be subscribed to
42-
the [squid-mirrors mailing
43-
list](http://lists.squid-cache.org/listinfo/squid-mirrors).
44-
45-
- country where the mirror is sited
46-
47-
- name of organization to be credited with sponsorship
48-
49-
- optional: a URL for the organization
50-
51-
- optional: a note about the mirror or sponsor
52-
53-
Registered mirrors are tested for accuracy regularly. Mirrors are
54-
removed from the public listings immediately if any problems are
55-
detected, and re-added automatically a short period after the issue is
56-
resolved. If the issues remains after several months the mirror is
57-
automatically de-registered and scanning will cease at that time.
58-
59-
To terminate a mirror stop the updates and erase all public content from
60-
the Squid Project. Please also notify the above contact to get scanning
61-
stopped early.
62-
63-
### Mirrors for www.squid-cache.org
64-
65-
Both IPv4 and/or IPv6 mirrors are accepted.
66-
67-
HTTPS mirrors are not working yet, if you want to provide one please
68-
contact **info at squid-cache.org** to discuss it.
69-
70-
- Mirrors updates should happen every 1-2 hours,
71-
72-
- no more than once per hour please.
73-
74-
- no less than once per day.
75-
76-
- Mirrors must remove content not in the master rsync directory.
77-
78-
- Mirrors must provide a publicly accessible server FQDN.
79-
80-
- The mirror must accept requests for www.squid-cache.org.
81-
82-
The website pages and content can be fetched from here:
83-
84-
rsync -avz --delete-after master.squid-cache.org::http-files /www/path
85-
86-
> :information_source:
87-
We have deprecated the use of country-specific mirror domains. If
88-
you have previously been assigned a mirror domain such as
89-
www1.us.squid-cache.org. Please change that to hosting just the
90-
www.squid-cache.org domain and contact **info at squid-cache.org**
91-
about the change.
92-
93-
### Squid reverse-proxies
94-
95-
Alternatively a Squid reverse-proxy can be supplied relaying requests to
96-
our master servers. Please indicate this in your contact email.
97-
98-
These mirrors are exempt from the update and removal timing requirements
99-
since they track changes. They are still scanned for correct operation.
100-
101-
The squid.conf snippet required is here:
102-
103-
http_port 80 accel vhost defaultsite=www.squid-cache.org
104-
105-
cache_peer master.squid-cache.org parent 80 0 originserver
106-
107-
acl squidcache dstdomain .squid-cache.org
108-
http_access allow squidcache
109-
cache_peer_access master.squid-cache.org allow squidcache
110-
cache_peer_access master.squid-cache.org deny all
111-
112-
### Mirrors for ftp.squid-cache.org
113-
114-
Package archive is split into two sections. An archive containing the
115-
full history of package releases and a volatile area only containing the
116-
most current supported packages.
117-
118-
- You may mirror either or both
119-
120-
- If mirroring both please use the same base /path
121-
122-
- Mirrors must be updated at minimum of daily
123-
124-
- Mirrors must be updated at maximum of 3-hourly
125-
126-
Mirrors which are public but restricted (ie to a certain country) are
127-
still worth registering. Just indicate this nature in your contact
128-
email. They will need to permit access for the scanners on
129-
master.squid-cache.org to test the mirror.
130-
131-
### Latest release bundles
132-
133-
rsync -avz --delete-after master.squid-cache.org::ftp-files /path/squid
134-
135-
### Package Archive
136-
137-
rsync -avz --delete-after master.squid-cache.org::archive /path/archive
138-
139-
## Mirrors for the source code tree
140-
141-
### Daily Snapshot
142-
143-
This code has passed simple quality checks to verify that trivial build
144-
problems are not going to occur. These are general build tests only.
145-
System-specific problems and runtime problems may still be found.
146-
147-
rsync -avz --delete-after master.squid-cache.org::source /source-path
148-
149-
Version specific code can be found in the numbered series
150-
sub-directories for their version. For example:
151-
152-
rsync -avz --delete-after master.squid-cache.org::source/squid-5 /source-path
153-
rsync -avz --delete-after master.squid-cache.org::source/squid-4 /source-path
154-
rsync -avz --delete-after master.squid-cache.org::source/squid-3.5 /source-path
155-
rsync -avz --delete-after master.squid-cache.org::source/squid-3.4 /source-path
156-
rsync -avz --delete-after master.squid-cache.org::source/squid-3.3 /source-path
157-
rsync -avz --delete-after master.squid-cache.org::source/squid-3.2 /source-path
158-
rsync -avz --delete-after master.squid-cache.org::source/squid-3.1 /source-path
159-
rsync -avz --delete-after master.squid-cache.org::source/squid-3.0 /source-path
160-
rsync -avz --delete-after master.squid-cache.org::source/squid-2.7 /source-path
161-
rsync -avz --delete-after master.squid-cache.org::source/squid-2.6 /source-path
162-
163-
### Hourly Snapshot
164-
165-
This code is the hourly latest update of code submitted to each branch.
166-
This code is direct from the repository, build QA checks may not have
167-
been performed.
168-
169-
Structure of the source branches matches that of the daily snapshots.
170-
171-
rsync -avz --delete-after master.squid-cache.org::source-hourly /source-path
12+
with donations of storage and bandwidth!

0 commit comments

Comments
 (0)