CLOUDCITY PROXY · Dezvoltatori

Pornire rapidă: prima cerere proxy

Folosește endpoint-ul unui serviciu activ pentru o cerere mică spre un site pe care ai dreptul să îl accesezi.

Documentație revizuită la 5 octombrie 2026

1. Confirmă serviciul activ

Deschide portalul cu contul CloudCity existent. Selectează serviciul eligibil activ și afișează explicit datele de conectare. O comandă, o activare în curs sau previzualizarea publică nu este un endpoint utilizabil. Notează exact hostul, portul, protocolul și metoda de autentificare.

2. Configurează mediul

Exemplele folosesc PROXY_URL, PROXY_USER, PROXY_PASSWORD și TARGET_URL. PROXY_URL este adresa completă a proxy-ului, cu protocol, host și port, fără utilizator sau parolă; de exemplu https://proxy.example.invalid:443. Copiază protocolul exact din serviciul activ, inclusiv https://. Introdu datele prin managerul de secrete sau mediul local; nu le salva în cod. Adresa .invalid este doar un exemplu. TARGET_URL trebuie să fie o pagină HTTPS mică, proprie sau autorizată.

3. Păstrează verificările transportului

Păstrează protocolul oferit de serviciu și verificarea certificatelor atât pentru proxy, cât și pentru ținta HTTPS. Nu înlocui https:// cu http:// pentru a evita o eroare. Un tunel CONNECT printr-un proxy HTTP nu criptează singur legătura către proxy. Pentru o eroare de certificat, verifică adresa și certificatele de încredere ale aplicației. Folosește timeout-uri și oprește cererile repetate până la rezolvare.

4. Inspectează rezultatul înainte de extindere

Verifică statusul și conținutul așteptat, nu doar succesul comenzii. 407 privește autentificarea proxy; 403 sau 429 pot proveni de la țintă ori din politica upstream. Oprește și depanează erorile repetate. Măsoară traficul pilotului și stabilește limite înainte de concurență mai mare.

Cerințe runtime

Exemplele sunt pentru proxy-uri HTTP/HTTPS. Folosește cURL și PHP cu suport pentru proxy HTTPS și certificate actualizate; Python cu requests; Node.js 20+ cu undici; Go 1.22+; Java 17+ cu Apache HttpClient 5.5; C# cu .NET 8+. Pentru alte protocoale, alege un exemplu compatibil din generator. Instalează dependențele în proiectul propriu. Codul este rulat de aplicația ta, nu de această pagină.

cURL · Exemplu, fără date reale
# Set these variables from your active service, locally.
# PROXY_URL includes the exact protocol, host and port, without credentials.
curl --connect-timeout 10 --max-time 30 \
  --proxy "$PROXY_URL" \
  --proxy-user "${PROXY_USER}:${PROXY_PASSWORD}" \
  --url "$TARGET_URL"

Python · Exemplu, fără date reale
# Requires: pip install requests
import os
from urllib.parse import quote, urlsplit, urlunsplit
import requests

user = quote(os.environ["PROXY_USER"], safe="")
password = quote(os.environ["PROXY_PASSWORD"], safe="")
address = urlsplit(os.environ["PROXY_URL"])
if address.scheme not in ("http", "https") or not address.hostname or address.username or address.password:
    raise ValueError("Use the credential-free HTTP or HTTPS proxy URL from your service")
proxy = urlunsplit((address.scheme, f"{user}:{password}@{address.netloc}", "", "", ""))
response = requests.get(os.environ["TARGET_URL"],
    proxies={"http": proxy, "https": proxy},
    timeout=(10, 20), allow_redirects=False)
print(response.status_code)

PHP · Exemplu, fără date reale
<?php
$request = curl_init(getenv('TARGET_URL'));
curl_setopt_array($request, [
    CURLOPT_PROXY => getenv('PROXY_URL'),
    CURLOPT_PROXYUSERPWD => getenv('PROXY_USER').':'.getenv('PROXY_PASSWORD'),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_CONNECTTIMEOUT => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_SSL_VERIFYHOST => 2,
    CURLOPT_PROXY_SSL_VERIFYPEER => true,
    CURLOPT_PROXY_SSL_VERIFYHOST => 2,
]);
$response = curl_exec($request);
if ($response === false) { throw new RuntimeException('Request failed'); }
echo curl_getinfo($request, CURLINFO_RESPONSE_CODE);
curl_close($request);

Node.js · Exemplu, fără date reale
// Node.js 20+; npm install undici
import { request, ProxyAgent } from 'undici';
const env = process.env;
const dispatcher = new ProxyAgent({
  uri: env.PROXY_URL,
  token: `Basic ${Buffer.from(`${env.PROXY_USER}:${env.PROXY_PASSWORD}`).toString('base64')}`,
  connect: { timeout: 10000 }
});
try {
  const result = await request(env.TARGET_URL, {
    dispatcher, signal: AbortSignal.timeout(30000),
    maxRedirections: 0
  });
  console.log(result.statusCode);
  await result.body.dump();
} finally { await dispatcher.close(); }

Go · Exemplu, fără date reale
package main

import ("fmt"; "net/http"; "net/url"; "os"; "time")

func main() {
    proxy, err := url.Parse(os.Getenv("PROXY_URL"))
    if err != nil || proxy.Host == "" || (proxy.Scheme != "http" && proxy.Scheme != "https") { panic("Invalid proxy URL") }
    proxy.User = url.UserPassword(os.Getenv("PROXY_USER"), os.Getenv("PROXY_PASSWORD"))
    client := &http.Client{Timeout: 30 * time.Second,
        Transport: &http.Transport{Proxy: http.ProxyURL(proxy)},
        CheckRedirect: func(_ *http.Request, _ []*http.Request) error { return http.ErrUseLastResponse }}
    response, err := client.Get(os.Getenv("TARGET_URL"))
    if err != nil { fmt.Println("Request failed"); return }
    defer response.Body.Close()
    fmt.Println(response.StatusCode)
}

Java · Exemplu, fără date reale
// Java 17+; Maven: org.apache.httpcomponents.client5:httpclient5:5.5
import org.apache.hc.client5.http.auth.AuthScope;
import org.apache.hc.client5.http.auth.UsernamePasswordCredentials;
import org.apache.hc.client5.http.classic.methods.HttpGet;
import org.apache.hc.client5.http.config.RequestConfig;
import org.apache.hc.client5.http.impl.auth.BasicCredentialsProvider;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.apache.hc.core5.http.HttpHost;
import org.apache.hc.core5.util.Timeout;

class ProxyCheck {
  public static void main(String[] args) throws Exception {
    var proxy = HttpHost.create(System.getenv("PROXY_URL"));
    var credentials = new BasicCredentialsProvider();
    credentials.setCredentials(new AuthScope(proxy), new UsernamePasswordCredentials(
      System.getenv("PROXY_USER"), System.getenv("PROXY_PASSWORD").toCharArray()));
    var config = RequestConfig.custom().setConnectTimeout(Timeout.ofSeconds(10))
      .setResponseTimeout(Timeout.ofSeconds(30)).setRedirectsEnabled(false).build();
    try (var client = HttpClients.custom().setProxy(proxy)
        .setDefaultCredentialsProvider(credentials).setDefaultRequestConfig(config).build()) {
      int status = client.execute(new HttpGet(System.getenv("TARGET_URL")), response -> response.getCode());
      System.out.println(status);
    }
  }
}

C# · Exemplu, fără date reale
// .NET 8+
using System;
using System.Net;
using System.Net.Http;

var proxy = new WebProxy(Environment.GetEnvironmentVariable("PROXY_URL")) {
    Credentials = new NetworkCredential(
        Environment.GetEnvironmentVariable("PROXY_USER"),
        Environment.GetEnvironmentVariable("PROXY_PASSWORD"))
};
using var handler = new HttpClientHandler { Proxy = proxy, UseProxy = true, AllowAutoRedirect = false };
using var client = new HttpClient(handler) { Timeout = TimeSpan.FromSeconds(30) };
using var response = await client.GetAsync(Environment.GetEnvironmentVariable("TARGET_URL"));
Console.WriteLine((int)response.StatusCode);

Exemplu, fără date reale. Consultă ghidul de pornire pentru variabile de mediu, TLS și instalare. Nu introduce secrete de producție într-o previzualizare publică. Citește ghidul de pornire →

Continuă cu

CLOUDCITY PROXY

Construiește integrarea cu așteptări clare.

Citește ghidul de conectare, compară cele patru familii sau discută configurația de care are nevoie proiectul.

Confidențialitate, pe scurt.

Alege scopurile pe care le permiți. Refuzul nu afectează contul, formularele sau cumpărarea unui serviciu.

Google Analytics ne ajută să înțelegem paginile comerciale și pașii de comandă. Nu trimitem datele profilului, domeniul tău sau conținutul tichetelor. Instrumentul rămâne oprit fără acord.

Politica privind cookie-urile
Cookie-uri necesare și alte detalii
Cookie-uri necesareMereu active · necesare funcționării

Sesiunea menține navigarea, iar tokenul de securitate protejează formularele; acestea expiră după 2 ore. Când alegi limba, cookie-ul cc_locale o reține timp de 365 de zile. Poți schimba limba oricând din meniu sau footer.

Preferința pentru această informare

Preferința păstrează versiunea, momentul și scopurile alese timp de 180 de zile, doar pe această gazdă și în acest browser. Nu conține numele sau adresa ta de e-mail. Poți retrage acordul oricând din acest panou.

Contul de client de pe my.cloudcity.ro folosește separat cookie-uri necesare autentificării și comenzilor. Detaliile complete sunt în politică. Poți redeschide oricând acest panou din „Setări cookie”, în footer.