{"id":9389,"date":"2025-08-11T22:49:20","date_gmt":"2025-08-11T20:49:20","guid":{"rendered":"https:\/\/www.nicalia.com\/nicapedia\/guias\/desarrollo-web\/guia-de-git\/guia-de-git-configurar-el-acceso-a-repositorios-privados\/"},"modified":"2026-06-01T09:40:35","modified_gmt":"2026-06-01T07:40:35","slug":"guia-de-git-configurar-el-acceso-a-repositorios-privados","status":"publish","type":"docs","link":"https:\/\/www.nicalia.com\/nicapedia\/guias\/desarrollo-web\/guia-de-git\/guia-de-git-configurar-el-acceso-a-repositorios-privados\/","title":{"rendered":"C\u00f3mo configurar el acceso SSH a repositorios Git privados desde cPanel"},"content":{"rendered":"<p>Para clonar y trabajar con <strong>repositorios Git privados<\/strong> desde un servidor con cPanel, la forma m\u00e1s segura es mediante <strong>autenticaci\u00f3n SSH con clave p\u00fablica<\/strong>. A diferencia de las credenciales de usuario y contrase\u00f1a, las claves SSH permiten autenticaci\u00f3n sin contrase\u00f1a de forma segura y son el m\u00e9todo est\u00e1ndar para despliegues automatizados.<\/p>\n<p>Esta gu\u00eda cubre el proceso completo: generar la clave en el servidor, registrarla en el proveedor y configurar SSH para m\u00faltiples repositorios. Aplica a <strong>GitHub, GitLab y Bitbucket<\/strong>. Si no est\u00e1s familiarizado con los comandos b\u00e1sicos, revisa primero la <a href=\"https:\/\/www.nicalia.com\/nicapedia\/guias\/desarrollo-web\/guia-de-git\/guia-de-git-comandos-comunes-de-git\/\">gu\u00eda de comandos Git m\u00e1s usados<\/a>.<\/p>\n<h2>Requisitos previos<\/h2>\n<ul>\n<li>Cuenta de <strong>cPanel<\/strong> con acceso SSH y Terminal habilitados.<\/li>\n<li>Acceso al servidor por SSH externo o mediante <em>cPanel \u2192 Avanzado \u2192 Terminal<\/em>.<\/li>\n<li>Permisos para a\u00f1adir <em>deploy keys<\/em> al repositorio privado en el proveedor.<\/li>\n<\/ul>\n<p>\u26a0\ufe0f En los ejemplos se usa GitHub, pero el procedimiento es pr\u00e1cticamente id\u00e9ntico para GitLab y Bitbucket. Las diferencias se indican en cada paso.<\/p>\n<h2>Paso 1 \u2014 Conectarse por SSH o abrir el Terminal de cPanel<\/h2>\n<p>Todos los comandos se ejecutan en el servidor, no en tu equipo local:<\/p>\n<ul>\n<li><strong>SSH externo:<\/strong> <code>ssh usuario@tudominio.com<\/code> desde tu terminal local.<\/li>\n<li><strong>Terminal de cPanel:<\/strong> <em>Avanzado \u2192 Terminal<\/em>. Es la opci\u00f3n m\u00e1s sencilla si no tienes cliente SSH configurado.<\/li>\n<\/ul>\n<h2>Paso 2 \u2014 Generar una clave SSH para el repositorio<\/h2>\n<p>Genera una clave SSH dedicada. Tener claves separadas por repositorio facilita la revocaci\u00f3n en caso de incidente sin afectar a otros repositorios.<\/p>\n<h3>Opci\u00f3n A \u2014 Ed25519 (recomendada)<\/h3>\n<pre><code>ssh-keygen -t ed25519 -f ~\/.ssh\/NOMBRE_CLAVE -C \"USUARIOCP@DOMINIOCP\"<\/code><\/pre>\n<p>Ed25519 es m\u00e1s moderna, m\u00e1s segura y genera claves m\u00e1s cortas que RSA. Compatible con GitHub, GitLab y Bitbucket actuales.<\/p>\n<h3>Opci\u00f3n B \u2014 RSA 4096 (m\u00e1xima compatibilidad)<\/h3>\n<pre><code>ssh-keygen -t rsa -b 4096 -f ~\/.ssh\/NOMBRE_CLAVE -C \"USUARIOCP@DOMINIOCP\"<\/code><\/pre>\n<p>Usa RSA solo si necesitas compatibilidad con servidores Git propios muy antiguos (OpenSSH &lt; 6.5).<\/p>\n<p>Sustituye <code>NOMBRE_CLAVE<\/code> por un nombre descriptivo (por ejemplo <code>mi-proyecto<\/code>), <code>USUARIOCP<\/code> por tu usuario de cPanel y <code>DOMINIOCP<\/code> por tu dominio principal. Ejemplo completo:<\/p>\n<pre><code>ssh-keygen -t ed25519 -f ~\/.ssh\/mi-proyecto -C \"usuariocp@midominio.com\"<\/code><\/pre>\n<p>Cuando pregunte por passphrase, <strong>d\u00e9jala vac\u00eda<\/strong> (pulsa Enter dos veces). Los despliegues automatizados no pueden introducir passphrase de forma interactiva.<\/p>\n<p>Se generan dos archivos: <code>~\/.ssh\/mi-proyecto<\/code> (clave privada \u2014 nunca la compartas) y <code>~\/.ssh\/mi-proyecto.pub<\/code> (clave p\u00fablica \u2014 esta es la que registrar\u00e1s en el proveedor).<\/p>\n<h2>Paso 3 \u2014 Crear y configurar ~\/.ssh\/config<\/h2>\n<p>El archivo <code>~\/.ssh\/config<\/code> indica a SSH qu\u00e9 clave usar para cada host. Sin \u00e9l, SSH intentar\u00e1 la clave por defecto y fallar\u00e1.<\/p>\n<pre><code>touch ~\/.ssh\/config\nchmod 0600 ~\/.ssh\/config\nchown USUARIOCP:USUARIOCP ~\/.ssh\/config<\/code><\/pre>\n<p>Abre el archivo:<\/p>\n<pre><code>nano ~\/.ssh\/config<\/code><\/pre>\n<p>A\u00f1ade la entrada para tu proveedor:<\/p>\n<pre><code>Host github.com\n    IdentityFile ~\/.ssh\/mi-proyecto<\/code><\/pre>\n<p>Guarda con <kbd>Ctrl+X<\/kbd> \u2192 <kbd>Y<\/kbd> \u2192 <kbd>Enter<\/kbd>.<\/p>\n<p><code>IdentityFile<\/code> apunta al archivo <strong>privado<\/strong> (sin extensi\u00f3n <code>.pub<\/code>). Si gestionas varios repositorios con claves distintas, consulta el Paso 6 para usar alias.<\/p>\n<h2>Paso 4 \u2014 Registrar la clave p\u00fablica en el proveedor<\/h2>\n<p>Muestra tu clave p\u00fablica y c\u00f3piala completa:<\/p>\n<pre><code>cat ~\/.ssh\/mi-proyecto.pub<\/code><\/pre>\n<p>Copia toda la l\u00ednea (empieza por <code>ssh-ed25519<\/code> o <code>ssh-rsa<\/code> y termina con el comentario).<\/p>\n<h3>En GitHub<\/h3>\n<ol>\n<li>Abre el repositorio privado \u2192 <strong>Settings \u2192 Deploy keys \u2192 Add deploy key<\/strong>.<\/li>\n<li>T\u00edtulo descriptivo (por ejemplo <em>cPanel producci\u00f3n<\/em>) y pega la clave p\u00fablica en <strong>Key<\/strong>.<\/li>\n<li>Marca <strong>Allow write access<\/strong> solo si el servidor necesita hacer push. Para despliegues de solo lectura, d\u00e9jalo sin marcar.<\/li>\n<li>Guarda con <strong>Add key<\/strong>.<\/li>\n<\/ol>\n<h3>En GitLab<\/h3>\n<ol>\n<li>Repositorio \u2192 <strong>Settings \u2192 Repository \u2192 Deploy keys \u2192 Add new deploy key<\/strong>.<\/li>\n<li>Nombre, pega la clave p\u00fablica y selecciona si otorgas escritura. Guarda.<\/li>\n<\/ol>\n<p>Alternativa: para acceso a toda tu cuenta, ve a <strong>Preferencias de usuario \u2192 Claves SSH<\/strong>.<\/p>\n<h3>En Bitbucket<\/h3>\n<ol>\n<li>Repositorio \u2192 <strong>Repository settings \u2192 Access keys \u2192 Add key<\/strong>.<\/li>\n<li>Etiqueta, pega la clave p\u00fablica y guarda.<\/li>\n<\/ol>\n<p>Alternativa: para acceso a nivel de cuenta, ve a <strong>Personal settings \u2192 SSH keys<\/strong>.<\/p>\n<p><!--\n=======================================================================\n  NICALIA \u2014 Git SSH repositorios privados \u00b7 PARTE 2 (pasos 5-7 + errores + FAQ)\n  Pegar a continuaci\u00f3n de la PARTE 1 en el editor de WordPress\n=======================================================================\n--><\/p>\n<h2>Paso 5 \u2014 Verificar que la autenticaci\u00f3n SSH funciona<\/h2>\n<p>Antes de clonar, comprueba que la clave est\u00e1 aceptada:<\/p>\n<pre><code>ssh -i ~\/.ssh\/mi-proyecto -T git@github.com<\/code><\/pre>\n<p>Para GitLab: <code>ssh -i ~\/.ssh\/mi-proyecto -T git@gitlab.com<\/code><br \/>\nPara Bitbucket: <code>ssh -i ~\/.ssh\/mi-proyecto -T git@bitbucket.org<\/code><\/p>\n<p>Respuestas de \u00e9xito:<\/p>\n<ul>\n<li>GitHub: <code>Hi usuario! You've successfully authenticated, but GitHub does not provide shell access.<\/code><\/li>\n<li>GitLab: <code>Welcome to GitLab, @usuario!<\/code><\/li>\n<li>Bitbucket: <code>logged in as usuario.<\/code><\/li>\n<\/ul>\n<p>Si aparece <code>Permission denied (publickey)<\/code>, revisa que la clave p\u00fablica est\u00e9 registrada correctamente en el proveedor y que <code>~\/.ssh\/config<\/code> apunte al archivo privado correcto.<\/p>\n<h2>Paso 6 \u2014 M\u00faltiples repositorios con alias (opcional)<\/h2>\n<p>Si gestionas varios repositorios con claves distintas, define alias en <code>~\/.ssh\/config<\/code> para que SSH use la clave correcta en cada caso.<\/p>\n<p>Ejemplo con dos repositorios en GitHub:<\/p>\n<pre><code>Host github.com-proyecto1\n    HostName github.com\n    IdentityFile \/home\/usuariocp\/.ssh\/proyecto1\n\nHost github.com-proyecto2\n    HostName github.com\n    IdentityFile \/home\/usuariocp\/.ssh\/proyecto2<\/code><\/pre>\n<p>Ejemplo con GitHub y GitLab simult\u00e1neamente:<\/p>\n<pre><code>Host github.com\n    HostName github.com\n    IdentityFile \/home\/usuariocp\/.ssh\/clave-github\n\nHost gitlab.com\n    HostName gitlab.com\n    IdentityFile \/home\/usuariocp\/.ssh\/clave-gitlab<\/code><\/pre>\n<ul>\n<li><code>Host<\/code> es el <strong>alias<\/strong> que usar\u00e1s en las URLs SSH al clonar.<\/li>\n<li><code>HostName<\/code> es el dominio real del proveedor.<\/li>\n<li>Usa <strong>rutas absolutas<\/strong> en <code>IdentityFile<\/code> cuando uses alias (con <code>\/home\/usuariocp\/<\/code>).<\/li>\n<\/ul>\n<h2>Paso 7 \u2014 Clonar el repositorio privado<\/h2>\n<h3>Con una sola clave para el host (sin alias)<\/h3>\n<pre><code>git clone git@github.com:USUARIO_REMOTO\/NOMBRE_REPO.git<\/code><\/pre>\n<p>Ejemplo:<\/p>\n<pre><code>git clone git@github.com:miempresa\/mi-proyecto.git<\/code><\/pre>\n<h3>Con alias definidos para m\u00faltiples claves<\/h3>\n<p>Sustituye el dominio del proveedor por el alias definido en <code>Host<\/code>:<\/p>\n<pre><code>git clone git@github.com-proyecto2:miempresa\/proyecto2.git<\/code><\/pre>\n<p>Una vez clonado, los comandos habituales (<code>git pull<\/code>, <code>git push<\/code>, <code>git fetch<\/code>) funcionan sin cambios adicionales dentro del directorio del repositorio.<\/p>\n<h2>Permisos correctos y buenas pr\u00e1cticas de seguridad<\/h2>\n<p>SSH rechaza las claves si los permisos son demasiado abiertos. Aplica siempre:<\/p>\n<pre><code>chmod 700 ~\/.ssh\nchmod 600 ~\/.ssh\/mi-proyecto\nchmod 600 ~\/.ssh\/mi-proyecto.pub\nchmod 600 ~\/.ssh\/config<\/code><\/pre>\n<p>Verifica con: <code>ls -la ~\/.ssh<\/code><\/p>\n<p>Buenas pr\u00e1cticas:<\/p>\n<ul>\n<li><strong>Una clave por repositorio:<\/strong> facilita la revocaci\u00f3n selectiva sin afectar a otros repos.<\/li>\n<li><strong>Claves de solo lectura para despliegues:<\/strong> no marques &#8220;Allow write access&#8221; salvo que el servidor necesite hacer push.<\/li>\n<li><strong>Rotaci\u00f3n peri\u00f3dica:<\/strong> regenera las claves cada 6-12 meses o cuando personal externo haya tenido acceso al servidor.<\/li>\n<li><strong>Documenta<\/strong> qu\u00e9 clave est\u00e1 en cada repositorio y qui\u00e9n es responsable.<\/li>\n<li><strong>Nunca copies la clave privada<\/strong> fuera del servidor. Si necesitas acceso desde otro equipo, genera una nueva clave en ese equipo.<\/li>\n<\/ul>\n<h2>Errores comunes y soluciones<\/h2>\n<h3>\u00abPermission denied (publickey)\u00bb<\/h3>\n<p>La clave p\u00fablica no est\u00e1 registrada o se copi\u00f3 incompleta en el proveedor. Verifica en <em>Deploy keys<\/em> del repositorio que aparece la entrada y que incluye el prefijo completo (<code>ssh-ed25519<\/code> o <code>ssh-rsa<\/code>).<\/p>\n<h3>\u00abWarning: Unprotected private key file!\u00bb<\/h3>\n<p>Los permisos de la clave privada son demasiado abiertos. Corr\u00edgelo con: <code>chmod 600 ~\/.ssh\/mi-proyecto<\/code>.<\/p>\n<h3>La prueba SSH funciona pero git clone falla con \u00abRepository not found\u00bb<\/h3>\n<p>Dos causas: (1) el usuario remoto o el nombre del repositorio en la URL son incorrectos \u2014 c\u00f3pialos desde el bot\u00f3n &#8220;SSH&#8221; del repositorio en la interfaz web; (2) si usas alias, la URL de clone debe usar el alias, no el dominio real.<\/p>\n<h3>\u00abHost key verification failed\u00bb<\/h3>\n<p>El servidor no tiene la huella digital del proveedor en <code>~\/.ssh\/known_hosts<\/code>. Ejecuta <code>ssh -T git@github.com<\/code> (o el proveedor correspondiente), acepta la huella cuando pregunte, y vuelve a intentarlo.<\/p>\n<h3>\u00abToo many authentication failures\u00bb<\/h3>\n<p>SSH prueba todas las claves de <code>~\/.ssh\/<\/code> y el servidor remoto corta la conexi\u00f3n por exceso de intentos. A\u00f1ade <code>IdentitiesOnly yes<\/code> al bloque correspondiente en <code>~\/.ssh\/config<\/code>:<\/p>\n<pre><code>Host github.com\n    IdentityFile ~\/.ssh\/mi-proyecto\n    IdentitiesOnly yes<\/code><\/pre>\n<h3>El archivo config no funciona aunque parezca correcto<\/h3>\n<p>SSH es sensible a la sintaxis: (1) la indentaci\u00f3n debe ser con espacios, no tabulaciones; (2) no debe haber espacios al final de las l\u00edneas; (3) los permisos del archivo deben ser exactamente 600. Verifica con: <code>ssh -G github.com<\/code> y comprueba que <code>identityfile<\/code> apunta al archivo correcto.<\/p>\n<h2>Preguntas frecuentes<\/h2>\n<h3>\u00bfCu\u00e1l es la diferencia entre una deploy key y una clave SSH de cuenta?<\/h3>\n<p>Una <strong>deploy key<\/strong> se registra a nivel de repositorio y solo da acceso a ese repositorio. Una <strong>clave de cuenta<\/strong> da acceso a todos los repositorios de esa cuenta. Para hosting y despliegues, las deploy keys son m\u00e1s seguras porque limitan el radio de da\u00f1o si la clave se compromete.<\/p>\n<h3>\u00bfEd25519 o RSA 4096?<\/h3>\n<p>Ed25519 si tu proveedor lo soporta (GitHub, GitLab y Bitbucket lo soportan todos en sus versiones actuales). Es m\u00e1s moderno y m\u00e1s seguro. RSA 4096 sigue siendo seguro y es la opci\u00f3n para servidores Git propios muy antiguos (OpenSSH &lt; 6.5).<\/p>\n<h3>\u00bfLa passphrase de la clave debe estar vac\u00eda?<\/h3>\n<p>Para despliegues automatizados desde cPanel, s\u00ed: debe estar vac\u00eda porque nadie puede introducirla de forma interactiva. Para uso personal e interactivo, una passphrase a\u00f1ade seguridad. Si necesitas passphrase en entornos automatizados, la alternativa es <code>ssh-agent<\/code>, aunque su configuraci\u00f3n en hosting compartido tiene limitaciones.<\/p>\n<h3>\u00bfPuedo usar la misma clave SSH para varios repositorios?<\/h3>\n<p>T\u00e9cnicamente s\u00ed, pero no es recomendable. Una clave por repositorio facilita la auditor\u00eda y la revocaci\u00f3n selectiva. El coste de gestionar varias claves es bajo con un <code>~\/.ssh\/config<\/code> bien organizado.<\/p>\n<h3>\u00bfC\u00f3mo revoco el acceso cuando ya no lo necesito?<\/h3>\n<p>En el proveedor, ve a <em>Deploy keys<\/em> y elimina la entrada. La clave deja de funcionar inmediatamente. En el servidor, elimina tambi\u00e9n los archivos: <code>rm ~\/.ssh\/mi-proyecto ~\/.ssh\/mi-proyecto.pub<\/code> y borra la entrada de <code>~\/.ssh\/config<\/code>.<\/p>\n<h3>\u00bfEste proceso funciona igual en GitLab y Bitbucket?<\/h3>\n<p>S\u00ed. Los pasos de generaci\u00f3n de clave, configuraci\u00f3n de <code>~\/.ssh\/config<\/code> y clonado son id\u00e9nticos. Solo cambia d\u00f3nde registras la clave p\u00fablica y la URL SSH: <code>git@gitlab.com:usuario\/repo.git<\/code> para GitLab y <code>git@bitbucket.org:usuario\/repo.git<\/code> para Bitbucket.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Para clonar y trabajar con repositorios Git privados desde un servidor con cPanel, la forma m\u00e1s segura es mediante autenticaci\u00f3n SSH con clave p\u00fablica. A diferencia de las credenciales de usuario y contrase\u00f1a, las claves SSH permiten autenticaci\u00f3n sin contrase\u00f1a de forma segura y son el m\u00e9todo est\u00e1ndar para despliegues automatizados. Esta gu\u00eda cubre el [&hellip;]<\/p>\n","protected":false},"author":5,"featured_media":0,"parent":9381,"menu_order":5,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-9389","docs","type-docs","status-publish","hentry","no-post-thumbnail"],"acf":[],"author_avatar":"https:\/\/secure.gravatar.com\/avatar\/c64e192e92bea4df8a48c5da36fb4618ceff98bc7377f1f887657a979722a633?s=96&d=mm&r=g","author_name":"Jose Manuel Garc\u00eda Romero","_links":{"self":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/9389","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/comments?post=9389"}],"version-history":[{"count":3,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/9389\/revisions"}],"predecessor-version":[{"id":9982,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/9389\/revisions\/9982"}],"up":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/9381"}],"wp:attachment":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/media?parent=9389"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_tag?post=9389"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_badge?post=9389"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}